Sorry, there is no help available for this item. For more information, choose one of the following topics using the Tab key and Enter or double clicking with the mouse: /
Table
Contents
Index
Help
using
Dragging Windows
Release the Mouse when you finish moving the window. Your mouse will thank you!
QmodemPro Help
Help
Menus
keys
Dialing
Directory
Status
Line
File
Transfer
Protocols
Terminal
Emulations
Index
Use the Tab key to move from item to item, and press Enter to view the selection. Using the mouse, double click on the selection.
1K-Xmodem
protocol,
description
1K-Xmodem/G
protocol,
description
43|50
strip,
video
toggles
strip
video
toggles
Add/Ins
Mouse
Button
ANSI
music
support,
Sound
configuration
ANSI
music
toggle
Answer,
commands
ASCII
protocol,
description
ASCII
protocol
options
Upload
CR
Handling
LF
Handling
Use
Xlate
table
Expand
blank
lines
EOL
Character
Speed
(ms.)
Download
CR
Handling
LF
Handling
Use
Xlate
table
Timeout
(seconds)
Auto
Answer,
Device
commands
Auto
Answer
Auto
start
directory
Auto-Increment,
Internal
protocol
options
Auto-Start,
Zmodem
options
Auto-Start
Base
address,
config
Batch
download,
External
protocol
options
Batch
Entry
Window
Batch
upload
path,
definitions
Batch
upload,
External
protocol
options
Batch
uploads
Baudrate,
Device
hardware
Beeps
bells
Break
delay,
Device
delays
Break
signal
Busy
result,
commands
Cancel
Dial,
Device
commands
Capture
Capture
checking,
Hardware
configuration
Change
directory
options
protocol,
description
Clear
screen
Clear
Color
selections
Communications
parameters
Config
Device
Emulations/Color
Fax
Files
Executeable
Programs
File
Definitions
Path
Definitions
Hardware
Host
Phonebook
Protocols
External
Internal
Sounds
Time/Date
Masks
Connect
message,
Device
commands
Connect
cycles,
Sound
configuration
Connect
tones,
Sound
configuration
Cover
Sheet
Filename,
method,
Zmodem
options
CTS/RTS,
Device
toggles
Data
bits,
Device
hardware
Date/Time
masks
Date/Time
Stamp
Default
Phonebook
Delay
after
dial,
Device
commands
Delay
during
dial,
Device
commands
Deleting
phonebook
entries
Device
configuration
Device
delays
Device
fine-tune
Device
Auto
answer
Break
Duplex
Toggle
Fine-tune
Hangup
Select
XonXoff
Toggle
Device
select
Device,
commands
Device,
hardware
Device,
toggles
Dial
prefix,
Device
commands
Dial
Prefixes
Dial
suffix,
Device
commands
Directory
configuration
Display
Nulls,
video
toggles
Doorway
Password,
shell
memory,
Hardware
configuration
Shell
Download
autostart,
External
protocol
options
Download
External
protocol
options
Download
path,
Download
path,
definitions
Download
tone,
Sound
configuration
Downloading
DSR/DTR,
Device
toggles
delay,
Device
delays
Locked,
Device
toggles
Duplex
Edit
Edit
phonebook
Editor
commands
Editor
Editor
Editor
Emulation
Enhanced
Doorway
mode,
Hardware
configuration
Erase
backspace,
video
toggles
Error
tone,
Sound
configuration
Executable
files
Exit
QmodemPro
Extended
keyboard,
Hardware
configuration
External
protocol
options
Class,
Device
hardware
Preferences
screen
File
date,
Internal
protocol
options
File
Batch
Upload
Entry
Capture
Change
drive/dir
Download
Edit
Exit
Log
Toggle
Log
Printer
Toggle
Shell
Upload
View
File
names
Find
phonebook
Flow
control,
Device
toggles
Flow
control,
Xon-Xoff
From
Company
name,
Function
Groups
phonebooks
Hang
modem
Hangup,
Device
commands
Hardware
configuration
Help
About
Contents
Debug
Help
Index
Previous
topic
Help
using
Host
commands
Host
configuration
Host
Internal
protocol
options
IRQ,
config
Kermit
options
Kermit
protocol,
description
Left
handed
mouse,
Hardware
configuration
Line
wrap,
video
toggles
Linefeeds
Mail
reader
Mail
Reader
Manual
time,
Modem
init,
Device
commands
Modem
init,
commands
Music
toggle
connect
message,
Device
commands
Notification
tones,
Sound
configuration
message,
Device
commands
message,
commands
Overlay
memory,
Hardware
configuration
Overlay
reserve,
Hardware
configuration
Overwrite
Internal
protocol
options
Parity,
Device
hardware
Path
configuration
Phonebook
options
Phonebook
Port
settings
Port,
Device
hardware
Post-print
setup
string,
Hardware
configuration
Pre-print
setup
string,
Hardware
configuration
Prefixes
Print
File/Device
Printer
capture
Printing
phonebooks
Protocol
name,
External
protocol
options
Quicklearn
phonebook
QuickLearn
pace,
Device
delays
Quicklearning
scripts
path,
definitions
Redial
interrupt,
Device
commands
path,
definitions
Revise
phonebook
entry
System
Primary
number
Alternate
numbers
Retries
User-ID
Password
Memo
Key
Script
Packet
Device
Emulation
TransferProtocol
Fax
Options
Duplex
Connects
Clear
button
Ring
count,
commands
Ring
message,
commands
Writing,
Internal
protocol
options
script
Save
partials,
Internal
protocol
options
Screen
size,
Hardware
configuration
Screen
Script
error
messages
Script
keywords
Script
parameters
Script
path,
definitions
Script
tokens
Scripts
Execute
Quick
learn
Scripts,
executing
Scripts,
Quicklearning
Scroll
record
Scroll
Scroll
Scroll
Lines
Select
character,
External
protocol
options
Send
replies
phonebook
Shell
Shutdown
Password,
Sorting
phonebooks
Sound
configuration
Sound
enabled,
Sound
configuration
Sound
toggle
Spacebar
advance
Split
screen
Status
Status
toggle
Status
line,
video
toggles
Status
Stop
bits,
Device
hardware
Strict
color,
video
toggles
Sysop
support,
System
date,
Internal
protocol
options
Table
Contents
Temporary
files
path,
Hardware
configuration
Terminal
emulation
Terminal
Translate
table
Trap
screen
Upload
External
protocol
options
Upload
path,
Upload
path,
definitions
Upload
tone,
Sound
configuration
Uploading
Video
25
43|50
8th
Strip
Add
ANSI
Music
Beeps
Bells
Clear
screen
Doorway
Emulation
Function
Scroll
record
Scroll
Split
screen
Status
Status
Trap
screen
Video
restore
exit,
Hardware
configuration
Video
toggles
View
Viewer
Viewer
Viewer
Virtual
memory,
Hardware
configuration
Virtual
reserve,
Hardware
configuration
Work
directory,
Xmodem
protocol,
description
Xmodem/CRC
protocol,
description
Xon-Xoff
Xon/Xoff,
Device
toggles
Ymodem
protocol,
description
Ymodem/G
protocol,
description
Your
number
Zmodem
options
Zmodem
protocol,
description
How to use Help
What you're reading right now is a "help screen". These help screens contain most of the information you will need to operate QmodemPro. #
Many help screens have highlighted items that will take you to another, related help screen. To access these items with the keyboard, press the Tab key to move from item to item (try it now). With the mouse, double click on the item. Here are some additional help items to get you started: B
Help
contents
Menu
commands
Dialing
Directory
Help
index
File menu
The File menu lets you perform file transfers with a remote system, and to manage QmodemPro files such as the log file.
Upload
Batch
Upload
Entry
Download
View
Edit
Capture
Toggle
Printer
Toggle
Change
drive/dir
Shell
Exit
File menu: Upload
Uploading is the process of transferring a file from your computer to another computer over a phone line or direct connection. Files are transferred using a transfer
protocol. Each side of the connection must be using the same transfer protocol in order for the transfer to be successful.
To begin an upload, you must first tell the system you are connected to that you would like to send a file. You may be prompted for additional information regarding the file you are about to upload, such as a short description of the contents of the file. u
Once the remote system has prompted you to begin uploading your file, select the Files/Upload menu option or press the PgUp key. QmodemPro will prompt you for the upload protocol (you must select the same protocol in QmodemPro as you have selected on the remote system). After you have selected the transfer protocol, you will be asked for the name of the file to upload.
When uploading files to CompuServe, this command is not used. CompuServe will instruct QmodemPro to automatically start the file transfer. You must have turned on CIS B+ Auto Start using the Config/Protocols/Internal/CIS
B+ configuration option.
See also: 4
File
menu,
Batch
Upload
Entry
File
menu,
Download
File menu: Batch Upload Entry
Some file
transfer
protocols are capable of sending several files during a single transfer. This is called a Batch transfer. c
If you are going to upload a number of files in a batch transfer, you may select these files before you connect to the system (this saves connect time and charges). The Batch Upload Entry menu selection from the Files menu will allow you to select files to upload ahead of time. Your selections will be saved to disk for later use by the Upload command.
See also: (
File
menu,
Upload
File
menu,
Download
File menu: Download
Downloading is the process of transferring a file from another computer to your computer over a phone line or direct connection. Files are transferred using a transfer
protocol. Each side of the connection must be using the same transfer protocol in order for the transfer to be successful.
To begin a download, you must first tell the system you are connected to that you would like to receive a file. If you are using a batch transfer protocol, you may be able to select more than one file to receive at once.
Once the remote system has prompted you to begin downloading your file(s), select the File/Download menu option or press the PgDn key. QmodemPro will prompt you for the download protocol (you must select the same protocol in QmodemPro as you have selected on the remote system). After you have selected the transfer protocol, you may (depending on the protocol) be asked for the name of the file for your computer.
Download protocols such as Zmodem, CIS B+, and certain external
protocols can start automatically without the use of the Files/Download command. You may need to enable this operation using the Config/Protocols menu selection.
See also: 2
File
menu,
Upload
File
menu,
Batch
Upload
Entry
File menu: View a File
This menu selection displays the selected file on your screen. By default, the internal QmodemPro editor will load the file in read-only mode, allowing you to browse through a text file. You may specify another file listing or viewing program of your choice by entering its name in the Config/Files/File-Preferences section.
See also:
File
menu,
File menu: Edit a File
This menu selection loads the selected file into the internal QmodemPro editor, allowing you to edit and save your changes to the file. You may specify another editor program by entering its name in the Config/Files/File-Preferences section.
See also:
File
menu,
File menu: Capture
This is a toggle which starts or stops the Session capture function. While Session Capture is active, the data displayed on the screen is also saved to a disk file. This key may be re-assigned using the @CAPTURE meta command on the Function
Keys screen. _
When you start a session capture, you will be prompted to enter the name of the capture file.
See also:
File
menu,
Toggle
File menu: Log Toggle
This command starts or stops QmodemPro Session Log recording. The Session Log feature is used to keep track of major QmodemPro activity. When the session log is active, QmodemPro writes an entry in the session log file reflecting information such as who was called, the date and time of the call and how long the online session lasted. Each log entry is time and date stamped.
See also: )
File
menu,
File
menu,
Capture
File menu: Log View
This function allows you to view the log from the Main Menu or Terminal screen. By default, the log file will be displayed on screen using the built-in QmodemPro editor. You may use an external file listing or viewing program, for instance Xtree or List, by specifying the program name in the Config/Files/File-Preferences section.
See also:
File
menu,
Toggle
File menu: Printer Toggle
This menu selection will cause QmodemPro to send all incoming data to the printer, if your system is equipped with one. This selection is a toggle. To stop printing, select this menu item again.
A Status window will be displayed on screen showing the new state of the toggle. The printer should be READY when this command is issued. If the printer is off-line or if there is no printer, QmodemPro will display an error message.
See also:
File
menu,
Capture
File menu: Change Drive/Dir
Use this option to change the current drive or directory.
File menu: Shell to DOS
If enough system memory is available and a copy of your Command Processor (usually COMMAND.COM) can be located via the "COMSPEC=" environment variable or in the DOS PATH, you may shell to DOS. r
To return to QmodemPro, type EXIT and press Enter at the DOS prompt. The screen will be restored when returning.
See also:
File
menu,
File menu: Exit
Use this command to exit QmodemPro. You will be asked if you would like to hang up the modem before exiting the program.
See also:
File
menu,
Shell
Phonebook menu
QmodemPro's phonebook, or dialing directory, is a dialog box organized in much the same way as your personal address book. Like your address book, it can contain information including the system name, telephone numbers, your login name, password, and communication parameters. You can also add notes to each entry, to record more detailed information and comments. Entries can be marked and organized into groups for multiple dialing sessions.
Device menu
The device menu allows you to select from any available devices, and send commands to the active device. Devices are installed and configured from the Config/Device menu. O
Select
Fine-tune
Hangup
Break
Auto
answer
XonXoff
Toggle
Duplex
Toggle
Device menu: Select
This menu item pops up a dialog box showing all available devices. You may switch to another device using this command.
See also:
Device
menu,
Fine-tune
Device menu: Fine-tune
This setting allows you to change communication parameters on the fly. Baud rate, parity, data and stop bits can be changed, and a Quick Picks selection allows common combinations to be selected from control buttons.
See also:
Device
menu,
Select
Device menu: Hangup
The Hang-up command is used to force the modem to terminate a call. In most cases, you would not use this command to disconnect from the remote computer; you would use the remote computer's standard logoff procedure. However, in case you are experiencing problems (remote computer lockup, bad line noise) you may use this command to disconnect the call.
Device menu: Break
This menu selection generates a BREAK signal. "BREAK" is a special signal generated by the serial adapter, used to notify the receiving computer of a specific condition. In most cases, BREAK is used to tell the other computer to interrupt whatever it is doing. a
You may set the length of the BREAK signal using the Config/Device/Delays configuration option.
Device menu: Auto-answer
This command sends the auto-answer string as specified in the Config/Device/Term
Cmds configuration option. The default is ATS0=1^M, which on a Hayes-compatible modem will activate the auto-answer feature.
Activating this command a second time will send the Modem Init command. Normally this will disable the auto-answer mode of the modem.
See also:
Host
Device menu: Xon-Xoff toggle
Xon/Xoff are software controlled transmit/receive signals which control the flow of text or data. While active, ^S will stop the flow of data and ^Q will restart it. Xon/Xoff is generally used to control text viewed on the screen or preventing data buffer overflow.
See also:
Config/Device/Toggles
Device menu: Duplex
This toggle switches QmodemPro operation between Full Duplex and Half Duplex modes. "Duplex" describes the method used in echoing your keystrokes back to your terminal screen. In Full Duplex mode, the remote system you are connected to echoes your keystrokes back to you. In Half-Duplex mode, the remote system does not echo your keystrokes, and QmodemPro must do it instead. <
An incorrect Duplex setting will yield one of two results: m
You do not see any keystrokes displayed on your screen as
you type. You should switch to HALF duplex.
Your keystrokes are duplicated (i.e. HHeelllloo). You
should switch to FULL duplex.
Video menu
This group of commands governs how your local terminal behaves. It is from this menu that you can select terminal emulations, turn on Music and Sound, define and edit function key macros, clear your screen, and record screen images to disk.
Emulation
Doorway
Strip
Beeps
Bells
ANSI
Music
Function
Clear
screen
Split
screen
43|50
Status
Status
Trap
screen
Scroll
Scroll
record
Video menu: Emulation
The Terminal Emulation feature allows QmodemPro to behave like a display terminal such as the popular VT100 from Digital Equipment Corporation. While in terminal emulation mode, QmodemPro interprets special control information so that it is displayed properly on the PC screen as if it were a native terminal of the selected type.
See also:
Config/Emulations
Video menu: Doorway mode
Doorway allows you to send the entire PC Keyboard Scan Codes across the line to the remote system. This is often used with BBS systems that make use of the arrow keys and PgUp and PgDn.
See also: '
Config/Hardware/Enhanced
Doorway
Video menu: Add LF to CR
In some cases, text lines may be overwritten on the screen. The most likely reason is that the other computer is not sending Linefeed (LF) characters at the end of each line.
This command toggles the addition of a Linefeed (LF) character to each incoming Carriage Return (CR). To turn the Add Linefeed feature OFF, select this command again.
See also:
Config/Emulations/Toggles
Video menu: 8th bit Strip
Some computer systems, for example CompuServe and GEnie, use the high bit of each 8-bit character for parity checking. If the high bit is not removed, the screen display will consist of high-order ASCII characters (ASCII 127+) such as foreign, graphic, or scientific characters. #
This command toggles the stripping of the high-bit ON and OFF. A status window will be displayed showing the new state of this toggle. QmodemPro starts in 8-bit mode by default. This can be changed with a Script command to automate high-bit stripping, for example when calling CompuServe. ]
The Status
Line will display an "8" or "7" in the Toggles area to reflect the current mode.
See also:
Config/Emulations/Toggles
Video menu: Beeps & Bells
The speaker is used as an audible notification when certain events occur, for example successful connection, or completion of a file transfer. Since the speaker volume cannot be adjusted, you may prefer to turn it off. You can toggle the noise on and off with this command.
See also:
Config/Sounds
Video menu: ANSI Music
This controls whether or not ANSI music will be played through the PC speaker when it is received. The default is set in the Config/Sounds menu.
See also:
Config/Sounds
Video menu: Function Keys
This selection allows you to assign repetitive keystrokes to Function Keys (FKey for short) and to re-define the operation of other keys on the keyboard.
Up to 48 FKey Macros may be programmed, in addition to 43 additional keys. Macros are stored in "Key Definition Files" with .KEY file extensions and user-assigned filenames. To execute an FKey Macro, press the desired key.
See also:
Function
Video menu: Clear screen
This command clears the screen of all information and resets default colors. For example, ANSI color screens displayed on some Bulletin Board Systems can reset your screen colors, sometimes leaving your screen black-on-black or blinking, which is probably not what you want. The Clear Screen command resets the color on your screen to your own color selections. T
The default terminal mode colors are set from the Config/Emulations/Colors screen.
Video menu: Split screen
In split-screen mode, QmodemPro divides the screen into two areas to separate incoming and outgoing text.
The larger section at the top of the screen is reserved for incoming text received from the remote computer. The smaller section at the bottom of the screen echoes transmitted keystrokes. The number of current keystrokes are displayed on the screen's dividing line.
Video menu: 25 / 43|50
This command switches between 25 line mode and 43 or 50 line mode (43 lines on EGA displays, 50 lines on VGA displays). The screen will be cleared following each display mode change.
See also:
Config/Hardware/Screen
Video menu: Status line
This command toggles ON and OFF the Status Line at the bottom of the screen. This is for normal Terminal mode only. When running the a script, QmodemPro Host, or most other "shortcut key" a commands, the appropriate status line(s) will be displayed.
See also: /
status
Video
menu,
Status
Video menu: Status line Info
The status line can be toggled between the QmodemPro standard with all the toggles and information, to one that shows you the Name and Number of the last dialed system.
See also: *
status
Video
menu,
Status
Video menu: Trap screen
Screen contents can be copied (trapped) to a disk file with this command. A dialog box will pop up asking you to input the name of the screen image file.
See also: -
File
menu,
Capture
Video
menu,
Scroll
Video menu: Scroll back
As the on-line session proceeds, all displayed information is stored in a scroll-back buffer. Select this menu function to select Scroll-back mode. While in this mode, you can scroll backward and forward through previously displayed text. The @SCROLLBACK meta command can be reassigned to another key, if desired, by using the Function
Keys screen.
See also: -
File
menu,
Capture
Video
menu,
screen
Video menu: Scroll back record
By default, QmodemPro stores all screen data in the scroll-back buffer for later recall. This command toggles the scroll-back buffer ON or OFF. A status window will appear, showing whether scroll-back buffer is ON or OFF.
See also:
Video
menu,
Scroll
Host menu
The Host is a small-scale BBS program that allows you to set up your computer to receive incoming modem calls. While online, callers can read and post messages, upload and download files, and take control of your computer to run other programs. N
You may also start the Qmodem Host from DOS with the following command line:
QMPRO /HOST
See also:
Device
menu,
answer
Mail menu
The mail reader menu allows you to read your electronic mail (E-Mail) directly from QmodemPro, using Off-Line Xpress (OLX) or another mail packet reader.
Scripts menu
This menu selection allows you to execute a script while running QmodemPro. A script is a "program" written in QmodemPro's built-in script language.
Execute
Quick
learn
Scripts menu: Execute
Use this command to execute a script. A dialog box will pop up allowing you to enter the name and path of the script you wish to execute.
See also:
Scripts
menu,
Quick
learn
Scripts menu: Quick learn
Use this command to begin "recording" a QuickLearn script. QmodemPro will analyze incoming and outgoing data, and create a script for you. You may need to edit the script before using it.
See also:
Scripts
menu,
Execute
Config menu
This is the QmodemPro "Control Panel". From this menu you can set all aspects of QmodemPro's operation and appearance.
Files
Path
Definitions
File
Definitions
Executable
Programs
Phonebook
Device
Emulations/Color
Protocols
Internal
External
Host
Hardware
Sounds
Time/Date
Masks
Config menu: Files
This configuration menu item allows you to save default path and file names for QmodemPro internal files, and names of other executable programs used by QmodemPro.
Config menu: Files / Path Definitions
This menu item lets you set up the directories that QmodemPro will use for file transfers and scripts.
Config menu: File Definitions
This dialog box stores name and path information for QmodemPro's internal files: Screen dump, Capture, Log and Scrollback. You may also set options for Print File/Device, and Scrollback buffer size in lines.
Config menu: Files / Executables Programs
This dialog stores the names of utility programs executed by QmodemPro, for instance an external file viewer or editor, and your mail reader.
Config menu: Phonebook
The appearance and behavior of your QmodemPro Phonebook are controlled from this configuration menu.
Config menu: Device
QmodemPro can communicate with a wide variety of hardware devices -- modems, Fax cards, and network modem pools, for example. Information about each device is stored in this section of the configuration.
Config menu: Fax
The configuration options available from this menu selection determine the appearance, arrangement and content of Faxes sent by QmodemPro. Normally, a Fax consists of a cover sheet identifying the sender and addressee, plus the actual text or graphic file being sent.
Config menu: Emulations/Color
The Terminal Emulation feature allows QmodemPro to behave like a display terminal such as the VT100 from Digital Equipment Corporation. While in terminal emulation mode, QmodemPro interprets video dependent information so that it is displayed properly on the PC screen as if it were a native terminal of the specified type.
Config menu: Protocols
This section allows you to customize options and toggles on the internal protocols and to install additional external file transfer protocols.
Config menu: Protocols Internal
These are settings which apply to the internal file transfer protocols.
Config menu: Protocols External
These are settings which apply to the external file transfer protocols.
Config menu: Host
These are settings which configure the behavior of your QmodemPro Host. You will also need to configure your modem hardware in the Configuration/Device section.
Config menu: Hardware
These configuration options allow you to customize the way QmodemPro behaves with your hardware, including memory, screen, keyboard, sounds, and mouse.
Config menu: Sounds
QmodemPro can generate a variety of sounds to signal a successful connect or the completion of a file transfer. These options allow you to configure the pitch and duration of these sounds.
Config menu: Time/Date Masks
To ensure the maximum amount of flexibility and to insure that the date, time, and elapsed time routines can be used internationally, you can specify a picture mask to indicate how the date and time entries should be formatted.
Help menu
The Help menu lets you access the QmodemPro help system. C
Contents
Index
Previous
topic
Help
About
Debug
Help menu: Contents
This option brings up a list of major help topics. You may use this as a starting point to browse the QmodemPro help system.
See also:
Help
Contents
Help menu: Index
This option brings up a list of all help topics sorted alphabetically.
See also:
Index
Help menu: Previous topic
This option returns you to the last help screen you looked at.
Help menu: Help on help
This option brings up information on how to use the QmodemPro help system.
See also:
Help menu: About
This selection brings up a dialog box identifying the QmodemPro version number, your Registration Name and QmodemPro Registration number.
Help menu: Debug Info
This screen displays internal program settings, for use by Mustang Software, Inc. tech support engineers.
Phonebook Config
These options let you configure the name of your default phone book, the way it looks, and the way it works.
Default Phonebook
This is the name of the phonebook that is loaded when you start Qmodem. The default name is QMPRO.FON. [
[X] Spacebar Tag Advance
When checked, the scroll bar in the phonebook will advance to the next entry when using the spacebar to tag. When a mouse double-click is used to tag an entry, the scroll bar will not advance. [
[X] Clear Tags on {FKEY}
When checked, all previous tags are erased when the {F2} through {F12} method of tagging is used. Otherwise the {F2} through {F12} tagging will cause additional entries to be tagged without clearing previously tagged entries. [
[X] Auto Start Directory
When checked, the Alt-D Dialing directory will be displayed automatically upon starting Qmodem. The only exception being that it will -not- be displayed if Qmodem is started with a Script command line parameter.
Add/Ins Mouse Button
( ) Add-Appends new entries
) Ins-Inserts at Scrollbar
If you have a mouse, these radio-buttons control what happens when the Add/Ins button is pressed with the mouse pointer. When set to Add, the button will perform an Append to the end of the phonebook. When set to INS, it will insert the new entry at the scroll bar. Keyboard users should note that the [Alt-A] will always add, and the Ins key will always perform the insert.
Phonebook: Revise Entry
The [Revise] button is used to change or edit information in directory entries. A dialog box will pop up allowing you to edit the name, telephone number, and other information. M
Select one of the following field names for more information on that field:
System User-ID
Pri.#1 Password
Alt.#2 Memo
Alt.#3 Key
Alt.#4 Script
Alt.#5 Packet
Retries
Device
use Fax
Options
Emulation Duplex
Transfer
Protocol Connects
Clear
Info
Phonebook: Fax To: [service name]
This dialog lets you fill in information about the FAX your are about to send.
To:
Enter the name of the person who is receiving this fax. You may make this a descriptive title if there is a group receiving this fax as in "Division Managers". This field will automatically be filled in with the information stored in the Memo field of the phonebook entry.
From:
Typically this would be your name or company name. This field will automatically be filled in with the information stored in the Config Fax "From or Company Name" field.
Subject:
This field is optional and should describe the contents of the fax.
Document:
This field is required and should specify the name of the TEXT file to fax. [
[X] Include Cover Letter
This box is automatically checked if you have defined a default cover letter in the Config Fax Cover Letter field. You can un-check this field if you do not wish to use the default cover letter. [
) Normal ( ) Fine
Fax documents can be sent in either Normal or Fine resolution. Fine resolution will look better on the remote fax machine, but at the cost of taking longer to transmit. /
OK
OK for All
Press [OK] when you are satisfied with the information about the fax and are ready to send it. If you have tagged more than one fax dial entry, you can press [OK for ALL] to send this information to all the tagged fax dial entries. Press [Cancel] to exit this dialog and not send a fax.
Phonebook: Manual Dial
The [Manual] button allows you dial a number that is not in your Phonebook. Manual dial commands may contain up to 40 characters and/or digits. The number is not checked for validity. The data typed in the Phone Number field will be passed to the modem as if it was attached to a real entry. Any Prefix modifier will be substituted accordingly. T
In addition, a Number
History is kept of the last manually dialed numbers.
Manual Dial: History
QmodemPro automatically stores manually entered numbers for the current session. To select a previously dialed manual entry, press your down arrow key to open the "history window", then use the highlight bar to select the number you wish to dial. Mouse users click the History button "
This history window is also linked to the Primary Number field in the Revise Entry dialog in your phonebook. This is especially convenient if you wish to store one or more manually-dialed numbers as permanent phonebook entries. To store the number, simply select the "Primary Number" field in the Revise Entry dialog box, press the down-arrow key and use the highlight bar to select the number you want to store.
Phonebook: Find
The Find command is used to scan the phonebook for a specific text string. Entry Names, Phone Numbers, UserID, Memo, Password, Script, Key, Packet and Attached Notes are searched starting with entry #1.
The find dialog box has a data entry field for the Text to Find, and four option buttons. The data entry field is a history list, which can be used to select and re-use previously entered text strings.
The option buttons are [Find], which searches for the first matching entry; [Again] which continues the search to the next matching entry; [Repeat & Tag] which automatically finds and tags all matching entries; and [Cancel], which returns to the Phonebook dialog box.
Phonebook: Edit
Three types of files may be edited from this button: Phonebook note files, script files, and Prefixes. The first two options pop up the QmodemPro Editor, while the third option pops up the Edit Prefixes dialog from the Configure Device menu. Refer to Editor
Commands for a complete list of commands supported.
Also included is the [Sort] button. This allows you to sort the current phonebook using any field as the primary sort in either ascending or descending order. See Phonebook
Sort for more information.
Edit: Sort
This allows you to Sort the current phonebook using any of the fields listed as the primary key and in either ascending or descending order.
For example, if you wanted to sort the phonebook so that the entry with the highest number of calls comes first, and so on down to the least called entry, you would check the (
) Total Connects and (
) Descending and press [OK].
Phonebook: Print
The [Print] button allows you to copy selected information from your phonebook to a printer or to a disk file. D
You will notice two windows full of check boxes. Any or all selected fields for each phonebook record may be printed. To select, use the arrow keys or mouse to move the highlight bar around each window, or type the highlighted letter for each item on the keyboard, then press the [Spacebar] to toggle selections on or off.
You may then select the print device or file. The default is PRN, the DOS print device. You may change this to another printer (for instance LPT2) or a DOS text file on disk (enter the path and file name to which you wish QmodemPro to save your Phonebook text file.
The output from the print phonebook command is one record per line, and is not formatted for line length. You should take your printer's maximum line length into consideration when selecting fields to output, and you may want to make use of the Pre
Post-Print
setup strings on the Config menu to change the "characters per inch" setting on your printer to accommodate wider lines.
Phonebook: Group Edit
This dialog box contains a window listing groups, and several control buttons.
Use the Group Name field to store the name of the group, using a descriptive name such as "Mailrun" or "Games" or "Local BBSs" or anything else that describes what these systems have in common. Note that you can add the same entry to more than one group.
The "Continuous for All" toggle in the next field instructs QmodemPro to dial each entry until you have connected with each system on the list.
The next two fields are selection lists. The window on the left side of the dialog box lists all your Phonebook entries, while the window on the right side lists the entries you have selected for your Group. To select an entry, highlight the system in the Phonebook Entries list, then press the Enter key, select the [Add] button or double-click the entry with the mouse. That name will then be copied automatically to the "Selected for Group".
To remove an entry from your Group, go to the "Selected for Group" window, highlight the entry you wish to delete, and press Enter, select the [Remove] button or double-click the entry with the mouse. To remove ALL entries from a group, press the [Clear] button.
When you have finished building or revising your group list, select [OK] to save. You will then be returned to the "Group Options" dialog box.
Phonebook: Group
Selected phonebook entries can be saved as named groups. These groups can be used for a variety of purposes, for instance you may select a group of entries and dial them immediately, or tag them for further processing from the Phonebook dialog box. )
To revise a group, highlight the group you wish to edit, then select the [Revise] button. The "Revise" dialog box operates in exactly the same way as the "Add" dialog box. The only difference is that [Add] begins with a clean slate, and [Revise] loads the information from the highlighted Group. d
To delete an entire group, highlight the group you wish to remove, and select the [Remove] button.
The [Tag Only] button is used to tag all the members of the group and returns back to the main phonebook. Note that this operation first un-tags any tagged entries in the Phonebook, then applies tags to the entries in the group.
The [OK-Dial] button is used to immediately begin dialing all members of the group. The "Dialer" dialog box will appear, showing the progress of the call(s). W
The [Close] button closes the "Group" dialog box and returns to the Phonebook screen.
Phonebook: Quick Learn
This button signals QmodemPro to create a QuickLearn script for the tagged entry. If no script file name has been specified for the entry, a dialog box will pop up, prompting you to enter a script filename. The letter "Q" will appear instead of a check mark in the "tagged" field beside the entry in the directory list.
Connecting to a Q-tagged entry activates the QuickLearn Script Recorder. When you connect, QuickLearn will begin rewriting the script for you.
Phonebook
QmodemPro's Phonebook, or dialing directory, is a dialog box organized in much the same way as your personal address book. Like your address book, it can contain information including the system name, telephone numbers, your login name, password, and communication parameters. You can also add notes to each entry, to record more detailed information and comments. And entries can be marked and organized into groups for multiple dialing sessions.
The Phonebook screen is divided into two sections. The upper section is a list box, displaying directory entries, while the lower screen section contains control buttons for all available Phonebook commands.
The Directory
The directory is organized in columns, with related information about each entry displayed horizontally across the screen.
This is the entry's position on the list. As you add and delete entries, the phonebook automatically re-sizes to accommodate the list. A maximum of 4095 entries are supported, and that's a lot of people to "reach out an touch" with a modem!
The next field consists of a group of symbol characters representing special attributes possessed by the entry next to which they appear. The meaning of these characters is as follows:
- This entry has a note file attached.
- This entry has been tagged as part of a dialing queue or
deletion.
- This entry corresponds to a FAX number instead of a
modem number.
- This symbol indicates that incoming and or outgoing mail
packets are present for the entry. The left pointing
arrow indicates an outgoing reply packet waiting, a right
pointing arrow indicates an incoming mail packet, while a
double pointed arrow indicates the presence of both
incoming and outgoing mail.
Service
The third field is for the "Service" name. This is the name of the Online Service, Bulletin Board System or remote computer. ~
The columns of information starting with "Primary Number" can be scrolled left and right using the scroll bar or arrow keys.
Phonebook: Dialer
The top left corner displays the System name, phone number, and hardware device through which the call is being made.
At the top right, the name of the script file attached to this entry is displayed, along with statistical information: last date connected, the last connection time, and the total number of connections to this system. B
The middle part of the screen shows the dialing information for this system: time to wait for a connection, seconds to pause between calls, and the number of dial attempts so far for this system. On the right is the current time, from the system clock on your computer, and the time the current dialing sequence started.
The bottom half of the dialog box is a status window, displaying the dial command, the device response, and the status of the timer.
When a successful connection is made, the screen will clear, and QmodemPro will go into terminal mode, allowing you to log into the remote system. -
While in the dialer window, pressing [Cycle] cancels the current call and starts dialing the next tagged entry. [Untag] cancels the current call, removes the entry from the queue and then moves on to the next entry in the queue. [Extend] increases the number of seconds in the current Timer display.
Phonebook: Send Replies
This dialog box shows all phonebook entries with outgoing mail packets waiting. You may remove any entries from this list which you do not want to dial by pressing [Spacebar] or double-clicking on the entry. All entries tagged when you press [OK] will be queued up and dialed automatically.
If you are using a login script that checks for the value of the GETMAIL flag, you may set this flag to "true" by checking the option box in the bottom part of this window.
Phonebook: Delete
The Delete dialog allows you to selectively delete the entire phonebook entry, just the attached Note File if any, or any outbound E-Mail REP or FAX files.
Selecting "Phonebook entry" will remove all three parts at once. In addition, all Groups are updated to remove the deleted entry.
You can tag more than one entry for deletion. In this case, the [OK for All] button allows you to set the "Items to Delete" just once, and then acts on all the tagged entries without further prompting.
If you press [OK] with multiple tags, each entry be displayed and allow you to set the "Items to Delete" for each one separately.
Error loading Phonebook
The phonebook specified is from an unknown version of Qmodem or QmodemPro. QmodemPro can recognize phonebooks created from Qmodem version 4.0 and above and convert them automatically.
Press [Try Again] to return to the dialog that prompted for the load, or [Overwrite] to delete the corrupted phonebook and create a new one with the name specified.
If you are not sure, always [Try Again] and examine the file to make sure it really came from a previous version of QmodemPro.
Phonebook Conversion
The phonebook you are trying to load is from an earlier release of Qmodem. The dialog will tell you from which previous version it is from and ask for confirmation to convert.
By default, the newly converted phonebook will take on the same name as the old version. In the process of the conversion, the old phonebook is automatically renamed to QMFON.OLD. If you have reason to continue to use the phonebook with the older version of Qmodem, you can simply change the name in the "New File" field before pressing [OK] and the older version will NOT be renamed. }
NOTE: If you convert more than one old phonebook, the previous QMFON.OLD file is overwritten with the -new- old phonebook.
Change Directory
This dialog allows you to select another directory from which to choose files for your batch upload.
If you know the drive:\directory you want, you can type it in directly in the "Directory Name" field. Or, you can tab into the "Directory tree" view and press Enter or double-click with the mouse to make that level the current directory. Changing the current directory will update the tree display to show the subdirectories below the current. Press [OK] when you have found the directory of choice, or [Cancel] if you do not want to change the current directory.
Batch Upload File Selection
Some file transfer protocols are capable of sending several files during a single "batch" transfer. This window allows you to select a batch of files.
Mask field
The default mask is "*.*", or all files in the default Upload directory, specified in the Configuration menu. You may specify any drive, directory, or filespec. DOS Wildcards are supported.
Add Mask
Use this button to add the current Mask to the Selected Files list. This allows you to use DOS Wildcards to send multiple files matching the wildcard filespec.
Files matching list
The Files Matching window shows a list of all files matching the current mask.
Add File
Use this button to add the highlighted file from the Files Matching list to the Selected Files list. You may also double-click a file in the Files Matching list to add a file to the Selected Files list.
Tree
Use this button to change
directories. A new dialog box will appear on your screen, allowing you to change drives and directories. The new path will appear in the Mask window, and files matching the mask will appear in the Files Matching window.
Clear All
Use this button to clear all selections from the "Selected files" window.
Selected files list
Files selected from the "Files matching" list will appear in this window. This is the list of files QmodemPro will use for the batch transfer.
Remove
Use this button to remove individual files from the Selected Files list. You can also double-click on entries in the "Selected files" list to remove them. 7
Upload
or Save Disk
This button changes depending on how you got to this dialog. If you pressed Alt+6, then the [Save Disk] will appear. This allows you to "pre-load" the Selected files list with your batch, and later you do not have to spend precious $$ entering this information online while the clock is ticking.
If you got here by pressing [Page Up], then [Batch Entry] from the "Upload a File" dialog, the [Upload] button is shown. You press this to begin the batch transfer. Remember, pre-loading the selected files will save you time and money!
Exit QmodemPro
Three options are presented: -
Yes
Exit to DOS and Drop DTR
Pressing [Yes] will immediately terminate QmodemPro, close the serial port (and hang up the modem if a connection was active), and close the Capture and Log files if they were open. +
No
Return to Terminal Mode
Pressing [No] or [Esc] cancels the exit request and returns to the Terminal Mode screen. -
Exit
Exit to DOS with DTR up
Pressing [Exit] will cause QmodemPro to exit to DOS and leave the DTR line active, which does not hang up the modem and retains the connection if one was active. This allows you to perform any other process, such as executing an external program and then return to QmodemPro still online.
Run a Script
Script to Run
Enter the name of a Script to execute. If you want a list of scripts, just press [Enter] or [OK] and an Open
Script dialog will appear.
Parameters
You can enter up to 10 optional parameters to be passed to the selected Script. These parameters must seperated by either a SPACE or a COMMA. Quoted strings can contain embedded spaces and are passed as one parameter. The script variables $0 through $9 receive the passed parameters.
Script Error
A problem was detected in the execution of the script.
Type:
This is the Script
Error
Message returned.
File:
The name of the script that was executing when the error occurred.
Line:
The line in the script that caused the error. B
To edit the script, press the [Edit Script] button. You will be placed in the Script editor and the cursor will be at the position that caused the error. If you are using an external editor, you will have to search for the line that caused the error. Press [Cancel] to return to Terminal Mode without editing the script.
Select Upload/Download Protocol
Selecting a protocol is the first step in a file transfer. This window shows the protocol list, including internal and (if configured) external protocols. As with all other QmodemPro dialog boxes, use your mouse or arrow keys to highlight the selection, then press [OK] to select and proceed with the operation. Internal Protocols are shown on left side of the list, and externals are shown on the right side. C
When transferring files, both the sending and receiving computers must use the same communication protocol. That means that if you have selected Xmodem-1k on the BBS, you must also select Xmodem-1k from the protocol selection window. Failure to match protocols at both ends can cause transfers to abort or otherwise fail.
Since each BBS or online service may use a slightly different method for selecting file transfer protocols, you should make sure you have selected the proper protocol on the BBS or online service before making the protocol selection in QmodemPro.
Host Mode Config
The Host Mode Config dialog box allows you to set up the configuration options for QmodemPro's Host mode.
Mode
) Open ( ) Closed ( ) Callback
An OPEN system is the simplest to use and maintain. Anyone who calls your QmodemPro Host will be permitted to log on and register as a new user. As new callers log in, QmodemPro Host automatically updates its user record file (QMHOST.PWD). All new users are assigned a security level of 0 (zero).
In a CLOSED system, only callers whose names and passwords are defined in the QMHOST.PWD file will be able to log on. If the caller's name is not on file, QmodemPro Host displays a brief message that the system is closed, and disconnects the caller.
A CALLBACK system mode is similar to a CLOSED system in that it requires the callers' name and passwords to be in the QMHOST.PWD file. In addition, CALLBACK requires that the callers' DATA Phone Number also be on file.
When callers log on, they will be instructed to hang up and place their modem into Auto-Answer mode. The Host will then hang up and immediately dial the caller's data phone number. @
Max Time
60
This defines the maximum time allowed per call, in minutes. The default value is 60 minutes. The maximum time allowed is 999 minutes (16 hours 39 minutes). [
DOS Password
The password required to Drop to DOS from remote. The default here is blank, which disables the Drop to DOS option completely. To enable remote Drop to DOS, enter a password in this field. j
Shutdown Password
To execute the "Shutdown Host" command, QmodemPro Host will prompt for a password. As with the DOS Password, this option is disabled by default, and can only be enabled by entering a password in this field.
Since you may wish to make file transfers available to your callers, the following two options will control which subdirectories callers can access. By default, both these paths are blank, disabling uploading and downloading.
Upload Path
All uploaded files will be stored into this directory. Any valid DOS directory may be entered in this field. Example:
C:\QMPRO\HOSTDIR\UPLOADS\
Download Path
All files available for download from the Host must be stored in this directory. Any valid DOS directory may be entered in this field. Example:
C:\QMPRO\HOSTDIR\
The Host File List command will list all of the files in this directory. Do not place files in this directory unless you want to make them available to callers.
Sysop Path Support
) Full Path ( ) DL Path Only
The two options are "Full Path" and "DL Path Only". The Full Path option allows those with Sysop security to specify a full drive, path and file name and thus allow downloading of any file on the system. IF the caller has a security level greater than 0, and IF the complete file path and name are entered. Note that only the path specified will be listed with the F command, so to use this sysop over-ride the exact path and file name must be known already. [
Selecting "DL Path Only" will restrict all file downloads to the specified Download path.
About QmodemPro
This selection brings up a dialog box identifying the QmodemPro version number, your registration name, and the registration number. Please have this handy when calling MSI for tech support.
NACS Port Select
Select the NACS port from the list. This will become the active device with which you will communicate through. Refer to your Novell System Administrator for a description of the NACS ports listed.
Fax Preferences
Cover Sheet Filename
This is the name of the TEXT file containing the information to print your personalized cover sheet when sending a fax. It is not required for proper fax operation, but usually is used to notify the receiving party what the contents of the fax is, how many pages, and so on.
Work Directory
This is directory where temporary files such as pre and post digitized images will be copied. It is also a good idea to store any generic PCX or cover sheet files in this directory.
Your FAX number
This is usually the phone number you are calling out with. It will be printed in small print at the top of every page.
From or Company Name
This is where you store the default From field information. If this is not blank, all prompts to send a fax will have the From: field filled in with this information. O
Resolution
) Normal ( ) Fine
The resolution controls how nice the fax will look on the receiving fax machine. Fine resolution will look better than Normal, but at the cost of taking longer to transmit.
Device: Description
Each device should be given a descriptive name. For example, if you have a V.32bis modem, plus a 2400 baud FAX modem card in your machine, you can store information about each device separately.
Device: Hardware
This dialog box allows you to enter information about the selected device.
Baudrate
( ) 110 ( ) 300 ( ) 1200 (
) 2400 ...
The Baud Rate is the speed at which the COM port operates and should in most cases match the top speed of the device, or the locked DTE speed for high speed modems. Supported speeds are 110, 300, 200, 2400, 4800, 9600, 19200, 38400, 57600 and 115200. QmodemPro will automatically use a lower speed upon connection, if necessary. The default baud rate is 2400. J
With many error-correcting and high-speed modems, the COM speed should be set higher than the modem's nominal communications speed. For example, the USR Courier v.32bis modem, rated at 14400 baud, functions efficiently with a COM speed of 38400 baud. Consult your modem manual for additional information on supported COM speeds.
Parity
) None ( ) Even ( ) Odd ( ) Mark ( ) Space
Parity is used to insure the validity of the data being transmitted and received. Parity values are None, Odd, Even, Mark and Space. This value must match that used by the computer being called. Most Bulletin Board Systems and Online Services use None (no parity), the default value. 7
Data
( ) 7 (
Characters transmitted over phone lines are made up of data bits. For systems which support text and binary program file transfers (i.e., most PC-based BBS systems), 8 data bits are required. When communicating with mainframe or minicomputer-based systems, 7 data bits is often used. Supported settings are 7 and 8. This setting must match that of the software operating on the remote computer. 7
Stop
) 1 ( ) 2
Stop bits are generated by the UART (Universal Asynchronous Receiver Transmitter, or serial port chip) to isolate transmitted characters. The majority of computer systems require 1 stop bit, the default value. Supported values include 1 and 2. As with other parameters, this value must match the computer's setting.
Port
) COM1 : 03F/04 ( ) COM2 : 02F8/03 ...
Ports from COM1 to COM8 can be selected from this list. Select the COM port to which your device is attached. #
Config Ports
Allows you to customize the Port
Configuration for COM1-COM8.
Interface
( ) Serial
( ) Int14/EBIOS
( ) NASI/NACS
( ) Digiboard
QmodemPro supports 4 specific interfaces to the device; Serial for standard PC based serial ports, Int14/EBIOS for network modem servers using standard Int14 or Int14 EBIOS redirectors, NASI/NACS following the Novell Asynchronous Server Interface, and Digiboard for the intelligent multi-port adapters.
When checked, this defines the device as supporting either Class 1 or Class 2 fax send capabilities. This box must be checked for the dialing directory to allow sending faxes. L
[ ] Fax Class 1 & 2
The default baudrate for the fax to negotiate with. Most PC fax modems support a setting of 9600 baud. It is also important to set the default baudrate to 19200 if the device supports fax. Because of this, you may want to "Clone" your default device and create a separate entry just for fax purposes.
Device: Hardware: Port Config
Port addresses are hardware-dependent values which define the computer's communications ports. QmodemPro allows you to define up to eight communications ports (COM1 through COM8). Two COM ports (COM1 and COM2) are standard for most IBM PC, XT, AT, PS/2 and compatible machines. This does not mean that all machines have both ports. These are optional. You still have to verify which ports you have available.
Com1 - Com8
This is the COM port number, from COM1 through COM8. The default is port 1. For port addresses higher than 2 be sure to configure the Base address and IRQ.
Base
These are the computer's COM port hardware addresses. QmodemPro supports default assignments for two serial ports, COM1 and COM2. For PC/XT/AT and compatibles equipped with IBM-standard adapters, the port address and IRQ assignments need not be changed.
On non-PS/2 machines, port assignments above COM2 are non-standard. Refer to the adapter or internal modem's documentation for specific hardware information. Generally, the following are valid for COM1 through COM4:
COM1 Base: 03F8 IRQ: 4
COM2 Base: 02F8 IRQ: 3
COM3 Base: 03E8 IRQ: 4
COM4 Base: 02E8 IRQ: 3
On the IBM PS/2 microchannel based computers, the following ports are considered "IBM Standard":
COM3 Base: 3220 IRQ: 3
COM4 Base: 3228 IRQ: 3
COM5 Base: 4220 IRQ: 3
COM6 Base: 4228 IRQ: 3
COM7 Base: 5220 IRQ: 3
COM8 Base: 5228 IRQ: 3
The IRQ (Interrupt ReQuest) value must be known for the serial ports to be accessed. When specifying Base addresses for non-standard COM ports, you must also set the correct IRQ values.
NACS Preferences
In this dialog, there are three fields and a list of current NACS devices that are available on the network. None of the entry fields are required and if left blank are considered "wildcard" matches to the network. If a field is filled in, then that is entry -must- be available on the net to make a successful connection to a modem. ,
The list in the bottom of the dialog will show all NACS devices that are currently available on the network. It will -not- show you devices that others may have already allocated. You may need to consult your network administrator for a complete list of available NACS devices in the modem pools.
To quickly fill in the Server, General and Specific fields, select from the list of available devices. Mouse users double-click on the entry, and keyboard users use the Space Bar.
Device: Hardware: Toggles
A number of settings are turned on and off from this dialog box. Z
Flow Control
[X] XON/XOFF
Xon/Xoff is a software flow control protocol used during normal text and ASCII transmissions. This toggle can also be changed from terminal mode with the Alt+1 command.
XOFF and XON are ^S (Ctrl+S) and ^Q (Ctrl+Q) characters, respectively. Most BBS and mainframe systems use XON and XOFF as a method of pacing text data transmissions. If the XON/XOFF toggle is ON, QmodemPro will send the XOFF character when its receive buffer is almost full.
As text is displayed, the receive buffer empties and can accept more data. QmodemPro then sends the XON character to resume transmission. Note that the XON/XOFF software flow control is not used during Binary file transfer protocols except Kermit and Zmodem. =
[X] CTS/RTS
When set to ON, QmodemPro uses hardware handshaking between the modem and computer. This is required for high speed and error-correcting modems. Since additional signals are required to implement hardware handshaking, make sure when using an external modem that your modem cable supports the CTS (Clear to Send) and RTS (Request to Send) signal lines. =
[X] DSR/DTR
DSR/DTR flow control is similar to CTS/RTS, but uses the Data Set Ready and Data Terminal Ready signal lines. :
NOTE: NEVER set this option when using a modem unless specifically told to by the remote system you are connecting to! This option is primarily for "direct connections to Mini and Mainframe computers. Setting this option for modems may cause the modem to hang up and drop carrier on receipt of full-screen text. =
[X] DTR Locked
The DTE (Data Terminal Equipment) speed, or port speed, is the rate at which your computer sends data to the serial port. Many high speed modems perform best when the DTE rate is locked at a higher rate of speed than the actual connect speed.
When ON, QmodemPro maintains the serial port speed at the rate defined in the phonebook entry being dialed. When set to OFF, QmodemPro allows the serial port speed to be determined by the speed identified in the modem's CONNECT message.
Miscellaneous
[X] Share Interrupts (IRQ)
When checked, QmodemPro will correctly share interrupts on PS/2 and EISA bus equipped systems. When left unchecked, interrupts are not passed on to previous interrupt handlers if any. If you are running a PC, XT or AT based system, this should be left unchecked. a
[X] Ignore Carrier Detect
When checked, the Modem Init string will be sent on startup regardless of the detection of a Carrier signal from the modem or device. Some modems insist on reporting a Carrier Detected (CD signal) until told to report the true state of carrier. If you have such a modem or device, then you will surely appreciate this switch! a
[X] Use 16550 if available
When checked, the 16550 (and 16550A) UART's FIFO buffers are enabled. Some defective clones of the 16550 may require you to uncheck this option. If you do not have a 16550 chip, then this switch is ignored. a
[X] 16550 Enabled in Shell
When checked, this leaves the 16550 UART FIFO buffers enabled for external protocols. If you have an external protocol that does not understand the 16550 UART, you may need to uncheck this switch. a
[X] Confirm Alt+H Hangup
When checked, the Alt+H Hangup command will prompt you to be sure you meant to hang up from the system you are online with. When unchecked, the Hangup command is issued immediately.
Device: Hardware: Commands for [device name]
The following set of commands determine the way your modem reacts while in terminal mode. There is a separate set of commands for the QmodemPro Host mode. |
Modem Init
ATE1Q0M1X4^M
This command resets Hayes and compatible modems to their standard operating parameters. This command may vary depending on the modem being used; consult the modem manual. |
Dial Prefix
ATDT
This command is used to tone-dial a number on Hayes and compatible modems. It is sent to the modem immediately before the telephone number to be dialed. For pulse dialing, change this to ATDP. |
Dial Suffix
^M
This string immediately follows the number to be dialed. Should your modem require a different End-of-Command character, you should place it here. |
Connect Msg
CONNECT
The message returned by the modem when a successful connection has been established. Most modems will also return the connect speed as part of the message, i.e. CONNECT 2400. Do not include a speed value as part of this message. Doing so will prevent a connection if the baud rate is different from the one you entered.
No Connect 1-4
(default varies)
These messages are returned by the modem when the connection could not be established. Your modem may return different messages; refer to the manual for additional information. j
OK Message
OK
The modem returns an "OK" message when the last command was received and executed successfully. For Hayes and compatible modems, use "OK". For modems which do not return a response to the Initialization command, leave this field blank. j
Cancel Dial
^M
This string will be sent to the modem when a dial request is to be canceled (when [Cycle] or [Untag] is pressed from the Dialer screen while dialing is in progress). Most modems accept ^M. If your modem seems intermittent canceling the call in progress, change this to ^M^~^M. j
Auto Answer
ATS0=1^M
This is the command to put the modem into "Auto Answer" mode, causing the modem to answer after receiving the number of rings specified. The complement to turn off Auto-Answer is sending the Modem Init command. If you use Auto-Answer, verify that your Modem Init command is sufficient to disable this in the modem or device. |
Hangup
^~^~^~+++^~^~^ATH0^M
This command will cause Hayes and compatible modems to hang up. Each ^~ pair causes a 1/2 second delay. In the example above, the +++ modem escape sequence is preceded and followed by a 1.5 second delay. This delay, referred to as escape guard time, is required for the modem to recognize the escape sequence and switch to command mode. The ATH0^M (note the 0 is a zero, not a capital letter O) command then instructs the modem to go on-hook (hang up). s
For modems which recognize lowering of the DTR signal as a disconnect method, enter the word DTR in this field.
Entering the word BREAK will send the modem BREAK signal. Some modems attached to PBX (Private Branch eXchange, or switchboard) require a BREAK in order to disconnect a call. j
Redial Intr.
RING
This message text, when received, will cause QmodemPro to stop dialing immediately. If you are sharing a voice line with your modem, this allows you to answer the phone personally. If your modem is connected to its own dedicated phone line, this field can be left blank. j
Delay During
60
This is the number of seconds QmodemPro waits for a connection after dialing a number. When this period has expired, QmodemPro will instruct the modem to hang up. j
Delay After
10
This is the number of seconds QmodemPro waits after an unsuccessful dial (that is, a BUSY signal), before trying the next number in the dialing queue (or the same number again).
Device: Hardware: Host Commands for
The following set of commands determine the way your modem reacts while in Host mode. ^
Init
ATS0=0M1Q0V1H0^M
This command string is sent to the modem each time the QmodemPro Host is started, and after each call. For Hayes compatible modems, the Host Init string should set Verbose result codes (Q0V1), disable Auto-Answer (S0=0), and place the modem on hook waiting for calls (H0). ^
Answer
ATA^M
The Answer string is sent to the modem when an incoming call (RING) is detected. ^
Busy
ATH1M0^M
This allows you to place the modem Off-hook when you log in as the local Sysop. Your phone line will return a busy signal preventing callers from connecting to the host system. ^
OK Msg
OK
The modem returns an OK message when the last command was received and executed successfully. For Hayes and compatible modems, use OK. For modems which do not return a response to the Initialization command, leave this field blank. ^
Ring
RING
When an incoming call is detected by the modem, it returns a special Ring Detect message. For Hayes and compatible modems, this is the word RING. When the ring detect message is received, the Host sends the Answer Command to the modem. ^
Ring Count
2
The Answer command is sent after detecting the number of rings in this field.
Device: Hardware: Prefixes/Suffixes for
Prefix and Suffix characters are used at the beginning or end of phone numbers (or anywhere between) to add standard and repetitive dialing information to the numbers as they are dialed. A prefix may be as simple as "Dial 9 to get out" or "Dial 1 for long distance", or it may hold a 7-digit SPRINT or MCI local access number. When used at the end of a number, the prefix becomes a Suffix which may be used to store a PBX access code, for example.
QmodemPro allows up to 10 Prefix codes per device, assigned to the letters A through J. Each prefix code can store up to 30 characters. You can use multiple Prefix codes in any position of the Number field of a dialing directory entry.
Device: Hardware: Device Delays
This dialog box allows you to set delays for Break, DTR, and QuickLearn Pace. You should normally leave these values at their defaults, unless there is a specific reason to change them. U
Break Delay
1000
This is the number of milliseconds that the BREAK signal will be sent when requested. U
DTR Delay
1000
This is the number of milliseconds that the DTR will be lowered when used in conjunction with the Hangup command. U
QuickLearn Pace
0
If this is set greater than 0, QuickLearn will append a "PACE=nnn" to each script SEND command. This should only be used if the system you are trying to create a script for cannot handle the data as fast as QmodemPro can send it.
Device Init Commands
The modem should respond "OK" to each command line sent to it by QmodemPro. If the modem does not indicate OK after each line of commands, this indicates a possible problem. First, try sending the modem configuration again. Then check to make sure the modem or device is turned on. Also check to make sure you have set the Hardware (a couple screens back) to the correct Port and Interface and retry. If the configuration of your modem fails or reports an error after a second try, we recommend you call MSI Technical Support for assistance.
Hardware Notes
This window contains information about dip-switch settings or other hardware notes. Pay careful attention to the dip-switch settings, if given. When you have followed the instructions, press the [Continue] button.
Device Quick Config
This dialog box shows the name of the device you have selected. If you need to change the COM port (the default is COM1), select [Hardware]. If you wish to proceed with the installation, select [Continue].
Device Quick Config
Using your mouse or arrow keys, move the scrollbar to highlight your modem from the list, and press [Enter]. Mouse users can double-click an entry to select as well.
If your modem does not appear in the list, select the modem type most closely matching your own from the Generic entries to get you going. Mustang Software Inc. continually solicits information from modem manufacturers and users so that we can keep our list up to date. If the Generic information does not seem to work with your modem, feel free to call our Technical Support department for assistance.
Select Device to Edit
QmodemPro can communicate with a wide variety of hardware devices -- modems, FAX cards, and network modem pools, for example.
The Device list is the heart of QmodemPro's ability to communicate. You can define up to 10 unique devices, or clone the same device making slight modifications. Such as, making your device use 7-E-1 or 8-N-1, a different baud rate, or even defining a fax modem so that one entry is for maximum speed on normal online communications and another specific to sending faxes from the dialing directory. a
The Default Device is the device that will be used when adding new entries to a phonebook, or when dialing with a phonebook that contains devices that you do not have defined. For example: you have a 2400 generic modem at home and your office has a high-speed whiz-bang do-it-all modem. The phonebook at the office would have the whiz-bang defined in all the dialing directory entries. You could bring home the QMPRO.FON phonebook and without revising any entries, dial from the office phonebook. Since the whiz-bang is not defined in your home device list, the "Default Device" will be used automatically!
Name
Allows you to change the name of the device when you upgrade or customize the device information. This can be any 20 character of your choosing. Such names as "2400 8N1 on COM1" are very descriptive, while "My Pet Modem" aren't. Both are valid.
Hardware
Allows you to customize the low-level interface for the device.
Toggles
Allows you to change the flow control and miscellaneous settings for the device.
Delays
Allows you to control things like BREAK and DTR delay.
Clone
Copies the currently selected device to the first empty slot, ready for you to tweak and change. 1
Device Quick Config
Allows you to pick from an extensive list of modems and devices for "quick" installation. When you upgrade modems, it will only take moments to install and be online.
Term Cmds
Allows you to customize the commands for dialing and general communications from Terminal mode.
Host Cmds
Allows you to customize the command for the Host mode.
Prefixes
Allows you to enter phonebook number Prefix and Suffix dialing commands to support such things as AT&T, MCI long-distance numbers, or even add something as simple as just dialing 9 to get to an outside line in an office.
Default
Allows you to change the Default Device should you have more than one defined.
Remove
Removes the highlighted device from the list. Note: You cannot remove your only device if you have just one defined. QmodemPro requires at least one device to function.
Close
Return back to the Config Menu and save any changes to the QMPRO.CNF file.
Macro Key Define
Enter up 70 characters to be sent when this key is pressed. Macros can also be used to store QmodemPro specific commands, such as @SCROLLBACK to view the scroll-back buffer. These "meta" commands are:
@SHELL @SHELLX
@UPLOAD @DOWNLOAD
@CAPTURE @DIAL
@BREAK @HELP
@MENU @EDIT
@SCRIPT @EDITWRAP
@STAMP @ADDLF
Script variables available through meta commands include:
$PASSWORD
$USERID
$MEMO
Key assignments for: [key filename]
This selection allows you to assign repetitive keystrokes to Function Keys (FKey for short) and to re-define the operation of other keys on the keyboard.
Up to 48 FKey Macros may be programmed, in addition to 43 additional keys. Macros are stored in "Key Definition Files" with .KEY file extensions and user-assigned filenames. To execute an FKey Macro, press the desired key.
Each key displayed in the dialog is capable of storing a group of characters (Max 70) that can be transmitted just by pressing the Macro key. Being somewhat limited in the dialog, only the first few characters of any macro key is actually displayed, even if all 70 characters are used. P
To change a macro, press the key displayed in the dialog you wish to redefine.
Function Keys
Function keys are in columns, left to right, as Normal Key, Shift+Key, Ctrl+Key and Alt+Key.
Keypad
These are the keys that are redefined when the NumLock is pressed on your keyboard.
101 Grey Keys
These are the keys that are available on 101-key keyboards when the Config Hardware Extended Keyboard support is checked.
Universal Support Keys
These are the keys that are available on all keyboards. In the case of non-101 keyboards, the arrows and Ctrl keys are when the NumLock is OFF on your keyboard.
Download File(s) / Batch
Selecting a Batch protocol for download requires that you enter a PATH for the received files to be stored. You do NOT enter a filename, just the PATH. The filename will be appended to this path at the time the transfer of the file begins. If you enter a filename with the path, the transfer will abort because the path does not exist. (because it will assume the filename is actually part of the path specification.)
Download a File
Enter the name and destination path of the file you wish to download.
Config: Hardware
These configuration options allow you to customize the way QmodemPro behaves with your hardware, including memory, screen, keyboard, sounds, and mouse. a
Overlay Memory
[X] EMS (Expanded)
[X] XMS (Extended)
You may elect to hold QmodemPro's overlay file partly or completely in memory. This will initially increase loading time as the overlay file is read into RAM, but may help speed program operation. [
Overlay Reserve (k)
The default value is 30K. If QmodemPro seems slow, this value should be increased in 5-10K increments until execution speed is satisfactory. Increasing this value will reduce disk activity during the loading of program overlay files, but at the expense of memory. If EMS or XMS are checked, and enough memory is available, you should leave this at the default setting. y
Virtual Memory
[X] EMS (Expanded)
[X] XMS (Extended)
[X] Disk File
These three options determine where QmodemPro will store the scrollback buffer; in Expanded (EMS) or Extended (XMS) memory, or in a temporary file on disk. d
Virtual Maximum (k)
1000
This option allows you to specify an maximum amount of virtual memory in EMS or XMS that QmodemPro will use. The default is 1000K.
DOS shell Memory
[X] EMS (Expanded)
[X] XMS (Extended)
[X] Disk File
When executing a DOS Shell command or external transfer protocols, QmodemPro will attempt to remove all but about 5K of itself from memory before all shell operations. ^
[ ] CGA Snow checking
Older CGA display adapters (and some CGA clones) may exhibit "snow" when video memory is accessed. If this is the case, set this toggle to ON. QmodemPro will use a different memory access method which may help alleviate the problem. This toggle is not used if your system is equipped with an MDA, EGA, or VGA display. While running under DESQview, you can set this to OFF for slightly improved display speed. ^
[X] Video Restore on Exit
When set ON, QmodemPro will attempt to restore the original mode of your video card to the settings prior to starting QmodemPro. If you prefer to exit and keep the video mode QmodemPro has set, select OFF. Note: it is not always possible to restore the video mode and depends on if you are using third-party screen drivers. e
Screen Size
) Startup
( ) 25 line
( ) 43/50 line
These three options govern which EGA or VGA display mode QmodemPro will use when it starts up. Select "Startup" if you wish to use the display mode in effect before starting QmodemPro; select 25 line or 43/50 line if you prefer one of these screen modes to override the screen size in effect when starting QmodemPro. ^
[X] Extended Keyboard
When set ON, QmodemPro uses an internal Interrupt 16 handler to access the 101-key enhanced keyboard. This usually allows the [F11] and [F12] keys to be used if they are present. When set OFF, the normal DOS interrupt handler is used, and you will not be able to use the [F11] and [F12] keys.
Some keystrokes require this to be set ON to be used. [F11] and [F12] have already been mentioned, The Status Line Info toggle shortcut key Alt+Enter, is another.
Note that if you do not have an enhanced keyboard, or if the BIOS does not support one, you cannot toggle this to the ON position. ^
[ ] Enhanced Doorway Mode
This toggle controls whether or not the enhanced 101-key E0(hex) codes are transmitted. This setting enables the gray arrow keypad to function independently of the numeric keypad.
When set ON, the special 3-byte code is sent for any of the enhanced keys. When set OFF, the E0 keys are converted to their 84-key keyboard equivalent. @
[ ] Left Handed
The Left Handed Mouse toggle merely switches the operation of the left and right mouse buttons, as a convenience to left-handed mouse users.
Pre-Print and Post-Print
These strings will be sent to your printer before and after printing text. The Pre-Print string normally contains printer control codes to set default fonts or make other printer settings. The Post-Print string would typically contain a Form Feed character, to eject the last page from the printer automatically. n
If you would like to include control characters in this string, type them as "^L" for [Ctrl+L] -- form feed. [
Please consult the manual with your printer for information on how to send setup strings.
Temporary files path
Specify the drive and path QmodemPro should use to create swap files and other temporary files.
Sound Options
QmodemPro can generate a variety of sounds to signal a successful connect or the completion of a file transfer. Whether or not the sounds are generated is controlled by the following items. Fields with the up/down pointers can be changed with the plus/minus keys as well as mouse clicks, or typing in the exact value. U
[X] ANSI Music Support
Setting this to ON will permit QmodemPro to play ANSI music if found in the incoming data stream. U
[X] Sound Enabled
Activates or deactivates the QmodemPro audible signals produced when connecting to another computer, or at the completion of a file transfer. )
Notification Tones
QmodemPro normally notifies you when significant operations take place. The tones sounded for these operations are configurable for pitch, and number of cycles. C
Connect Tone 1-3
QmodemPro produces a 3 note jingle following a successful connection. The default frequencies for the three notes are 1200, 1400, and 1600 cycles. The higher the number of cycles, the higher the pitch of the sound.
These can be changed to suit your taste. To change a value, type in the desired number or use your mouse on the up and down scrolling arrows. 4
Cycles
This entry controls the maximum number of iterations of the Connect tones when you connect with an entry dialed from the Phonebook. Remember, this is the maximum number. You can always cancel the tones with a press of any key while they are playing. m
Download Tone
1200
Upload Tone
1200
This is the frequency in cycles of the beeps that are produced at the completion of each file transfer. The default frequency for the file transfer completion tones is 1200 cycles. R
Error Tone
120
This is the frequency of cycles of the beep when QmodemPro notifies you of an error. The default frequency is 120 cycles, which produces a low buzzing sound.
Date/Time Masks
To ensure the maximum amount of flexibility, and to insure that the DATE, TIME and ELAPSED TIME routines can be used internationally, you can specify a picture mask to indicate how the date and time entries should be formatted. Please consult chapter 8 of your manual for full information.
Upload a File
If you are sending one file, type its path and name in the data entry window which will appear after you have selected your transfer protocol. a
If you are sending more than one file, using a batch protocol, select the [Batch Entry] button.
Zmodem Options
The following options are specific to Zmodem configuration. I
CRC Method
( ) CRC16
) CRC32
Two methods of CRC calculation can be used for Zmodem transfers, 16 bit and 32 bit. In most cases 32 bit CRC would be appropriate, though in situations where the remote host does not support 32 bit CRC, change this option to 16 bit. I
Auto-Start
) Enabled
( ) Disabled
When Auto-Start is enabled, Zmodem file downloads are started automatically whenever a Zmodem download transfer header is received. If this parameter is disabled, Zmodem downloads must be started manually with the [Page Down] command.
Kermit Options
The default options provided in this dialog box are correct for most circumstances, and should NOT be changed except on the advice of the System Administrator of the system you plan to call.
CIS B+ Options
) Disabled
Since the characters used for the CIS B+ transfer header may appear with some frequency in non-CIS sessions and thus cause unwanted initiations of CIS B+ transfers, you may choose to disable recognition of the CIS B+ transfer header. Operation of ENQ/ACK sequences is also disabled with this option. L
( ) Auto Start
When Auto-Start is enabled, CIS B+ file downloads are started automatically whenever a CIS B+ download transfer header is received. L
( ) Emulate ENQ/ACK
This setting allows the ENQ/ACK functions to work where needed, without triggering a CIS B+ download.
ASCII Protocol Options
This screen is divided into two parts, ASCII
Upload and ASCII
Download. They control how an ASCII file transfer is handled.
Internal Protocol Options
These are settings which apply to the internal file transfer protocols. e
[X] Overwrite Old
[ ] Auto-Increment
When you are prompted for a filename in one of the download protocols, a check is made to see if the file already exists. If it does, the Auto-Increment flag is checked. If it is set ON, then the filename is incremented, and the transfer begins. Incrementing a filename consists of changing the last character of the filename to a 0 (zero), then a 1, and so on. @
These two toggles work in tandem to control how downloaded files are If the Auto-Increment flag is set OFF, then the Overwrite Files flag is checked. If this is set ON, the existing file is deleted and the transfer begins. If it is set OFF, then you are prompted for a different filename before the transfer can begin. L
[X] Save Partials
A Partial is created when the Save Partials flag is set ON and a download aborts. The portion that has been received successfully is not deleted. If it is set OFF, then any partially downloaded file is erased when the transfer aborts. O
[ ] RTS When Writing
This toggle controls CTS/RTS hardware flow control when writing to disk during a binary file download. When this toggle is OFF, QmodemPro drops the RTS (Request to Send) signal while writing data to the disk, and raises RTS after the data has been written. )
When this toggle is ON, the RTS signal remains on during disk writes. This allows QmodemPro to overlap disk and serial port activity while downloading data on systems equipped with hardware-handshaking modems. For this option to work properly, the CTS/RTS Flow Control toggle must be ON as well. Y
( ) System Date
) File Date
These two options allow you to specify your preference of file date and time on batch transfers. If you prefer to have all downloaded files dated the actual day and time you received them on your computer, select "System Date". If you prefer to keep the original date on the file, select "File Date."
External Protocol Edit
Select Character
This is the letter or digit used to select this protocol for a file transfer. Note that the characters A, X, C, O, Y, F, G, K, B and Z are internal protocol definitions. If you define an external protocol with one of these letters, it will disable the internal protocol corresponding with that letter. j
Protocol Name
The written name of the protocol as it will appear in the upload/download Protocol Selection window. j
Download BAT
The name of the download batch file for the external protocol. The same batch file parameters that are passed in the Upload Batch file are also passed to the Download Batch file. j
Upload BAT
The name of the upload batch file for the external protocol. This batch file is used to actually perform the transfers, and makes use of a number of environment variables passed by QmodemPro. The four batch file parameters are passed as %1, %2, %3 and %4:
%1 Serial Port Speed (Computer to Modem)
%2 Serial Port # (Current COM Port number)
%3 Connect speed (as reported by Modem, CONNECT xxxx)
%4 Filename (if required, otherwise blank)
Batch Download
( ) Y (
Batch Upload
( ) Y (
Select the appropriate radio button if the protocol allows batch transfers. p
Download Autostart
Many file transfer protocols are designed to recognize a particular sequence of characters as the signal to begin a download, without the usual procedure of pressing the [Page Down] key. Zmodem is a good example of a transfer protocol capable of "Autostart", as are several others.
The documentation with the external protocol driver will specify whether or not the protocol is capable of Download Autostart, specifying the sequence of characters used to signal a download.
External Protocol Support
This screen allows you to enter the names and other information about external transfer protocols you want to add. These protocols can then be called from an upload or a download and used as if it were built into QmodemPro.
External protocols require an executable protocol driver program in order to function with QmodemPro. These protocol drivers are frequently available for download from Bulletin Board Systems and Online Services. Some examples might include DSZ from Omen Technologies, or HS/Link, a popular bi-directional transfer protocol which allows files to be uploaded and downloaded simultaneously.
Config: Files: Path Definitions
This dialog box stores the following path information: p
Download
Files transferred from a remote system to your PC by QmodemPro will be placed by default in the subdirectory specified in this line. p
Upload
Files transferred from your PC to a remote system will be sent by default from this subdirectory. You may, of course, enter a full path and file name for a file stored elsewhere on your drive. p
Batch Upload
This is the first path automatically supplied to the Batch Upload pick list. Note that the Batch Upload function allows files from multiple paths to be selected. p
Script
This is the default path for script files (.SCR) files executed by QmodemPro. Script files loaded from the QmodemPro command line must be stored in this subdirectory. p
QWK / IN
This is the path for .QWK mail packets and CompuServe/MCI Mail .IN packets downloaded by QmodemPro. For most efficient operation, the same QWK/IN path should be specified in the configuration section of Off-Line Xpress. p
REP / OUT
This is the path for .REP reply packets and CompuServe/MCI Mail .OUT packets to be uploaded by QmodemPro. Once again, this should be the same as your REP/OUT path in your Off-Line Xpress configuration.
Config: Files: File Definitions
This dialog box stores name and path information for QmodemPro's internal files such as Screen Traps, Captures, Logs, Scrollback and the print device or filename. Also stored here is the maximum number of Scrollback lines you wish to use, and the settings for Auto-Log Start and Date/Time stamping. p
Screen Trap File
SCREEN.TRP
This is the name of the file in which Screen Traps (Alt+T) are stored. The entire screen contents are saved to this file. If the file exists, the new trap is appended. p
Capture File
CAPTURE.CAP
This is the name of the file used for Screen Captures (Ctrl+Home or @CAPTURE). As text appears in terminal mode, it is also written to this file when open. p
Log File
QMPRO.LOG
This is the name of the file used to Log QmodemPro activity (Alt+0). Actions such as connections, file transfers, and hanging up are logged with a date/time stamp. p
Scroll Back File
SCROLL.SAV
This is the name of the file that is used when you save your scrollback buffer (Alt+UpArrow or @SCROLLBACK). All lines in the current scrollback can be saved minus any color. p
Scroll Back Lines
32000
This is the maximum number of lines of Scrollback that QmodemPro will attempt to keep. Depending on the type of Virtual Memory defined and available, you may or may not actually have this many lines. Should memory be available, this just sets the maximum. Values in the range 0 - 32000 are valid. Zero lines disables the scrollback option. p
Print File/Device
PRN
This is the default Printer or Filename to print to with the Print Echo (Alt+9) command. When enabled, characters received in terminal mode are also written to this device or filename. d
File Options
[ ] Auto-Start Log
When checked, the Log defined above will automatically be opened every time you start QmodemPro. This is a good way to track ALL your calls and operations while running. If the log is open when you exit, it is closed automatically. U
[ ] Date/Time Stamp
When checked, the LOG file will have a Date/Time stamp before each entry.
Config: Files: Executable Programs
This dialog stores the names of utility programs executed by QmodemPro and their default paths. If external Editors and Viewers are needed, this can be set as well. g
Viewer
This is the name of the External File Viewer of your choice. If you do not want to use the built-in viewer, enter the name of the program you wish to use. This should be a program or batch file that is locatable in the PATH or current directory of your computer. g
Viewer Path
This is the default Path -passed- to the viewer program. Depending on how the viewer is invoked, a filename may be appended to this path. This is NOT where your external Viewer program is located.
Viewer Type
) Internal (Path Only)
( ) External
Selecting Internal will use the Internal Viewer. The (Path Only) means that only the Path specified above will be used and the external program specified will be ignored. ^
Selecting External will use the external viewer specified and the above path as the default. g
Editor
This is the name of the External File Editor of your choice. If you do not want to use the built-in editor, enter the name of the program you wish to use. This should be a program or batch file that is locatable in the PATH or current directory of your computer. g
Editor Path
This is the default Path -passed- to the editor program. Depending on how the editor is invoked, a filename may be appended to this path. This is NOT where your external editor program is located.
Editor Type
) Internal (Path Only)
( ) External
Selecting Internal will use the Internal Editor. The (Path Only) means that only the Path specified above will be used and the external program specified will be ignored. ^
Selecting External will use the external editor specified and the above path as the default. g
Mail Reader
OLX
This is the name of your External Mail Reader program.
Device Fine-Tune
This dialog box shows the current settings of the active device. The active device can be temporarily modified by selecting from the options. The Quick Pick buttons represent a collection of the most-often used settings. The next time this device is loaded, these changes will disappear.
Device Select
This is a list of all available devices. Make your selection by using the arrow keys or mouse pointer, then press [Enter] to select the new device.
Translate Table
Translation may be necessary when communicating with another computer whose ASCII codes (the computer's alphabet) do not match those used by your PC. There are 256 ASCII characters, ranging in value from 0 to 255.
The Input table controls which incoming characters are allowed and which are translated to other characters, while the Output table controls which characters are sent out your modem to the other system.
Selecting Input or Output displays a screen containing the first 128 ASCII values (0 through 127) and their respective translations. To display and edit the High Bits, use the [Swap Hi/Low] button. <
To change (translate) an incoming or outgoing ASCII value:
1. Using the mouse or the [Tab] key, move the highlight bar to the desired ASCII value you want to strip or replace. The number on the left is the original ASCII value; the number on the right is the translated character which you will see when the original character is received.
2. Enter the ASCII value in decimal of the character you wish to translate. To strip the character, replace the number on the right with a 0 (Zero). S
3. Use the [OK] button to save your chances, or [Cancel] to discard your changes.
Video Toggles
This configuration menu item allows you to set defaults which will apply to individual terminal emulations. L
[ ] Strict Color
Strict Color will control what color is selected when Esc[m or Esc[0m is executed. When set ON, the color becomes "white on black." When set OFF, it becomes the color set by "Screen Text" in the color configuration section. To remain compatible with previous versions of QmodemPro, the default is OFF. L
[X] Line Wrap
This controls how the cursor reacts when it writes a character in the last column on the screen (usually column 80). When set ON, the cursor moves the next line down, performing a Line Feed if the cursor was on the last line on the screen. When set OFF, the cursor writes the character in the last column, but does not advance to the next line. L
[ ] Display Nulls
This controls how the NULL (0x00) character is handled when received. If this is set ON, then the Null character is displayed as a Space. When set OFF, the NULL is stripped from the incoming screen. L
[X] Status Line
This toggle controls displaying of the status line (the last line of the physical screen). When OFF, the QmodemPro status line is not displayed and the last screen line is available for incoming text display. When ON (the default), the status line is used to display the status of the Terminal mode and options of various command windows. L
[X] Erase Backspace
This controls whether or not the character to the left of the cursor is erased when a Backspace character (^H or DEL) is received. When ON, the character is erased before the cursor is moved to the left. When OFF, the cursor moves leaving the character to the left untouched. L
[ ] Add LF to CR
Different kinds of computers use different characters to indicate a line ending. The IBM PC and compatible machines use two characters, a Carriage Return and a Line Feed, to end a line and move to the beginning of the next line. Some other computers, however, use only a Carriage Return, with no line feed.
If each line of text in terminal overwrites the previous line, rather than displaying on the next line of the screen, try setting this to ON. L
[ ] 8th Bit Strip
This toggle turns the stripping of the high-bit ON and OFF. QmodemPro starts in 8-bit mode by default. This can be changed with a Script command to automate high-bit stripping, for example when calling CompuServe. Some BBSs use fancy graphics characters and ANSI escape codes. To display these properly, 8 bit mode must be in effect. ^
The Status Line will display an "8" or "7" in the Toggles area to reflect the current modem.
Color Selections
The colors and screen attributes of virtually every part of QmodemPro can be customized from this menu, and each terminal emulation mode can have its own complete set of custom colors.
The Monochrome Herc and LCD Laptop entries are intended for standard monochrome displays and Liquid Crystal Displays (LCD) on laptop computers, which can only display shades of gray. A pre-defined selection of Bronco Blue, Raging Red and Passion Purple shades are provided. e
Colors are a cosmetic feature and have no effect on QmodemPro's operation. First-time users should select one of the pre-defined color combinations and concentrate on other sections of the QmodemPro setup. Colors may be customized easily after all other operational parameters. The default colors can always be restored from the "Install Default" section.
The Custom Colors screen allows you to preview your color selections. QmodemPro displays color options appropriate to the type of video adapter in your system: Normal, Highlight, Underline and Inverse for monochrome systems capable of displaying these attributes, or a palette of foreground and background colors. Use your mouse or arrow keys to highlight and select colors from these palettes.
Colors
The Custom Colors screen allows you to preview your color selections. QmodemPro displays color options appropriate to the type of video adapter in your system: Normal, Highlight, Underline and Inverse for monochrome systems capable of displaying these attributes, or a palette of foreground and background colors. Use your mouse or arrow keys to highlight and select colors from these palettes.
Group
Since virtually every part of the screen display in QmodemPro can be given its own color scheme, various parts of the display have been grouped together to simplify the configuration process. The groups include Terminal, Status Line, Menus, Dialogs, Help, and Editor.
Item
Each group has an associated list of items, describing characteristics. For most displays, these items might include Normal, or active, Disabled, or inactive, and Selected. Some groups have more items, some have fewer. ;
Foreground/Background/Blink
This part of the dialog box allows you set the colors or attributes for each item.
Sample window
This window allows you to preview your color selections before saving. The colors selected from the foreground and background palettes, or list of monochrome attributes, will be displayed as they will appear on your QmodemPro screens. 4
Mouse Users: To quickly locate a specific item, first select the Group display you want to change, then simply click in the Sample window in the bottom on the text or area you want to change. The Item will auto-focus to where you clicked and you can make your change in the Foreground/Background palettes.
Color Selections
This dialog box gives you the option to apply your color selections to the current emulation, all emulations, or cancel and ignore your chances.
[Current]
Changes are applied to the current emulation only and saved in the QMPRO.EMU file.
[All]
Changes are applied to all emulations and saved in the QMPRO.EMU file.
[Cancel]
You decide you don't like the color scheme you have created and want to make it go away as quickly as possible.
Terminal Emulation
The Terminal Emulation feature allows QmodemPro to behave like a terminal other than a standard PC display, for example the VT100 from Digital Equipment Corp. While in terminal emulation mode, QmodemPro interprets device-dependent information so that it is displayed properly on the PC screen as if it were a native terminal of the specified type. Note that terminal emulations can also be specified for individual phonebook entries. J
Many of the most popular terminal emulations are supported by QmodemPro:
TTY No emulation at all
ANSI Emulates the ANSI.SYS of PC-DOS
VT52 Emulates the Digital VT52
VT100/102 Emulates the Digital VT100
VT220/320 Emulates the Digital VT220
WYSE 50 Emulates the WYSE 50 terminal
TVI925 Emulates the Televideo 925
IBM3101 Emulates the IBM 3101 model 10
HEATH Emulates the Heath terminal
DBUG_A Debug ASCII Mode
DBUG_H Debug HEX Mode
AVATAR Super-set of ANSI for OPUS BBS systems.
Emulation to Edit
This is the list of emulations supported by QmodemPro. 5
Default Emulation
This is the emulation that is selected when you start QmodemPro.
Toggles
Allows you to customize the display attributes of the selected emulation.
Colors
Allows you to change the colors throughout QmodemPro based on the selected emulation. Since each emulation stores the entire color palette, you could change each emulation so you could tell at a glance which emulation you were using!
Input
Allows you to change the Input Translate table for the selected emulation.
Output
Allows you to change the Output Translate table for the selected emulation.
Default
Allows you to change the default emulation to be used when starting QmodemPro.
Phonebook Device List Mismatch
There are one or more entries in the phonebook being loaded that point to devices you do not have defined. This more of an information dialog than an error. When one of the entries in the phonebook is dialed, and it tries to use one of the devices in this list, the Default Device defined in Config Device will actually be used.
In the case of sharing phonebooks between to different installations of QmodemPro, it is possible that each site has defined different devices. This is OK, and without any user intervention, both can immediately dial with the phonebook and not have to revise anything. B
To keep this dialog from displaying, simply "clone" your default device in Config Devices and rename the cloned entry to match one of the devices that shows in this dialog. Repeat this for all the devices shown. Next time you load this phonebook, all the devices will be locatable and you need not see this dialog again.
Or, you can press the [Replace with Default] button. This will go through the new phonebook and replace any devices listed as not found with your current Default Device.
Terminal Emulation
The Terminal Emulation feature allows QmodemPro to behave like a terminal other than a standard PC display, for example the VT100 from Digital Equipment Corp. While in terminal emulation mode, QmodemPro interprets device-dependent information so that it is displayed properly on the PC screen as if it were a native terminal of the specified type. Note that terminal emulations can also be specified for individual phonebook entries. J
Many of the most popular terminal emulations are supported by QmodemPro:
TTY No emulation at all
ANSI Emulates the ANSI.SYS of PC-DOS
VT52 Emulates the Digital VT52
VT100/102 Emulates the Digital VT100
VT220/320 Emulates the Digital VT220
WYSE 50 Emulates the WYSE 50 terminal
TVI925 Emulates the Televideo 925
IBM3101 Emulates the IBM 3101 model 10
HEATH Emulates the Heath terminal
DBUG_A Debug ASCII Mode
DBUG_H Debug HEX Mode
AVATAR Super-set of ANSI for OPUS BBS systems.
The current terminal emulation can be changed from the main menu Video/Emulation setting. Characteristics of each terminal emulation are discussed in greater detail in the Appendix of your QmodemPro manual.
Editor: [file in edit]
The QmodemPro editor uses the following standard Wordstar-like commands. Press [F10] to save your file and return to QmodemPro. 2
Editor commands
Ctrl+A word left
Ctrl+B reformat paragraph
Ctrl+C page down
Ctrl+D move right
Ctrl+E line up
Ctrl+F word right
Ctrl+G delete character
Ctrl+KB mark beginning of block
Ctrl+KC block copy
Ctrl+KH hide block
Ctrl+KI indent block
Ctrl+KK mark end of block
Ctrl+KR read block from disk
Ctrl+KU un-indent block
Ctrl+KV move block
Ctrl+KW write block to disk
Ctrl+KY delete block
Ctrl+L find again
Ctrl+N insert new line
Ctrl+P print next control character as literal text
Ctrl+QC go to end of text
Ctrl+QD go to end of line
Ctrl+QF find text
Ctrl+QR go to start of text
Ctrl+QS go to start of line
Ctrl+QY delete to end of line
Ctrl+R page up
Ctrl+S move left
Ctrl+T delete word
Ctrl+V insert toggle
Ctrl+W scroll down
Ctrl+X line down
Ctrl+Y delete line
Ctrl+Z scroll up
Shift+Del cut block
Ctrl+Ins copy block
Shift+Ins paste block
Ctrl+Del clear (delete) block
Alt+Bksp undo
Script Error
The WAITFOR command has timed out while looking for the specified text. Either specify a greater TIMEOUT value, or include an Error Label on the TIMEOUT command. If it should time out again, it will branch to the label specified so you can handle the time-out condition, possibly looping back and trying again to execute the WAITFOR command.
Information
The CIS B+ protocol cannot be started with the PgUp or PgDn (Upload or Download) keyboard commands. CIS B+ is always initiated by CompuServe and sends a signal to QmodemPro to begin the appropriate Upload or Download transfer.
Error
The Path you specified does not exist. Try using the TREE button to display the current directory tree for the specified Drive.
Error
The File Mask specified is in error. Masks must specify wildcard characters ? or *.
Error
The phonebook specified does not exist. If you select OK, the phonebook will be created.
Error
You have already defined all 10 external protocols. You need to Delete an entry before attempting to Add a new one.
Error
The Document specified does not exist. The name of a file that already exists must be entered before a fax can be sent.
Error
The specified Print Device does not exist, or the filename specified cannot be created. If you are trying to print to a printer, make sure the is hooked up and you have specified the correct port to print to. If you are trying to print to a disk file, make sure the drive and path (if specified) exist.
Error
All Groups must have be given a name to reference. Enter a descriptive name for the group you have just created and save the group to disk.
Error
The Name you have assigned to this Group is already in use by another Group. Names must be unique so that the Group Dial option cannot be confused and execute the wrong group.
Error
You need to first Add a group before executing any group dialog commands. (except the Add command!)
Warning
The script you have entered to QuickLearn already exists. If you continue, there is the possibility that you will overwrite a script in use by another dialing directory entry. Unless you are sure, it is advisable to enter a new script name that does not exist.
Information
There are no more matches to the text Find command.
Information
For QuickLearn to work, a script name must be entered in the phonebook. You can either Revise the phonebook entry and enter a script name, or press "Q" and let QmodemPro prompt you for the new script name (and it will revise the phonebook entry for you!)
Information
All of the entries tagged to dial have either been dialed, or untagged.
Warning
You have made changes to the phonebook entry. If you do not want to save these changes, you can press Yes to cancel the changes. Pressing No will place you back in edit mode for the entry.
Confirm
If you press Yes, the Hangup command will be issued to cancel the current connection. If you press No, you will return to terminal mode still online.
Error
There was an I/O Error writing to the QuickLearn Script file. Check to see if you have run out of disk space.
Confirm
Changes have been made and not saved! Pressing Yes will save the changes. Pressing No will abort any changes made.
Confirm
Your active device is reporting that there is a Carrier present and you are already online. If your active device cannot control the carrier, or you want the person you are connected with to use your Host, then press Yes. Pressing No will return you to terminal mode without starting the Host.
Confirm
Your active device is reporting that there is a Carrier present and you are already online. If your device cannot be programmed to remember to report the true state of the carrier, you can check the Ignore Carrier Detect box in Config Device Toggles. If you are already online, press No to skip sending the Modem Init command.
Confirm
There is no log file to view. You can toggle the log file on with the Alt+0 command, or make the log auto-start from the Config Files File-Definitions dialog.
Confirm
There are no lines in the scrollback to view. Make sure you have defined the number of scrollback lines in Config Files File-Definitions.
Error
An error occurred trying to execute a second copy of COMMAND.COM, or the command processor pointed to by the SET COMSPEC= environment variable. Make sure this points to the command processor of your operating system and that it actually exists where you pointed it to. Also be sure to use a complete Drive:\Path to the command processor.
No help required for this entry.
Terminal Mode
You are currently in Terminal Mode. Anything you type will be sent to the modem, and anything received from the modem will be displayed on the screen. (
Press Alt+Z to access the menu
system.
See also: 0
Status
Table
Contents
Help
index
Change Directory
This dialog allows you to select another directory from which to choose files for your batch upload.
If you know the drive:\directory you want, you can type it in directly in the "Directory Name" field. Or, you can tab into the "Directory tree" view and press Enter or double-click with the mouse to make that level the current directory. Changing the current directory will update the tree display to show the subdirectories below the current. Press [OK] when you have found the directory of choice, or [Cancel] if you do not want to change the current directory.
Registration Information
Here you fill in your name or the name of the company who purchased the copy of QmodemPro. The registration number can be found in the front of your QmodemPro printed manual.
This is for informational purposes only and can be recalled while running QmodemPro from the ?-Help/About box. Have this information handy if you need to call MSI for tech support.
Open File
The Open File dialog allows you to view a list of files matching a wildcard filename. The bottom of the dialog shows you the current directory, and the specific DOS file information about the currently highlighted entry.
You can type in the filename in the "Name" field, press Enter to select a file from the "Files" list, or double-click on a name in the "Files" list.
Write Block
Select a file name and path to save the marked text to a disk file. This is a "History Window", which saves your previous selections for recall. To make a selection from the history list, use your Down Arrow key, then make your selection from the list of options shown.
Find
Type the text you wish to search for in the window. This is a "History Window", which saves your previous selections for recall. To make a selection from the history list, use your Down Arrow key, then make your selection from the list of options shown.
Script Error Messages
CAPTURE Filename not found
The CAPTURE command expected a WORD parameter and it was either missing or a STRING was specified. 9
DOWNLOAD Filename expected
The command was not followed by any text or the following text was not a WORD. 9
DRIVE Letter A..Z expected
The DRIVE command did not receive a character between A and Z as a parameter. A
EGA value must be 25, 43 or 50
The value passed to the EGA command was not 25, 43 or 50. Use a correct value. )
ERROR opening FILE
An error occurred in OPENFILE Check the filename and correct. 7
ERROR Opening Script File
The script file was found, but could not be opened. Make sure the file is not locked in a network environment. 3
ERROR reading from FILE
An error occurred in a READFILE command. Make sure that the file contains valid data. /
ERROR writing to FILE
An error occurred in a WRITEFILE command. Make sure the file is not locked by a network or multi-tasker, and that you are not running out of disk space, and try again. '
File already open
Two OPENFILE commands were issued without an intervening CLOSEFILE. Only one file may be opened at a time.
FILE not open
READFILE or WRITEFILE was issued before the file was opened with OPENFILE. Check the script logic. 1
FILE not open for READ
READFILE was issued against a file opened for REWRITE or APPEND. The file must be opened for READ. A
FILE not open for WRITE/APPEND
WRITEFILE was issued against a file opened for READ. The file must be opened for WRITE or APPEND. =
FKEY Filename does not exist
The filename specified in the LOADKEY command does not exist. G
FLUSH keyword not KBD, COM or ALL
The FLUSH command requires the keyword KBD, COM or ALL. Correct and retry. ;
FON Filename does not exist
The filename specified in the LOADFON command does not exist. 1
GETSCR Nested too deep
GETSCR/PUTSCR commands can be nested 3-deep. A 4th GETSCR was detected without a corresponding PUTSCR. 9
GRAPHICS Keyword not found
GRAPHICS was issued without a parameter or with an invalid one. Correct and re-try. ?
Insufficient space for String
STRING memory is exhausted. You have exceeded the memory of your machine. %
INTEGER expected
The command expected an INTEGER value (-32768 to 32767). The variable or string was null or contained non-integer data. S
INTEGER value required for INCR or DECR
The VARIABLE argument in an INCR or DECR command did not contain an integer value. Check script logic and ASSIGN commands and insure that numeric data is stored into the variable. '
Invalid IF Opcode
The IF command requires one of 6 comparison Opcodes. Make sure the Opcode is correct and that necessary quotes are used. 5
Invalid KEYWORD or TOKEN
The first word in the line was not a valid KEYWORD, or the KEYWORD was passed the wrong type of data or Token. E
Invalid LABEL or misplaced Colon
A colon : was found at the beginning of a line. This may be an invalid LABEL or the colon needs to be changed to a semicolon if the line contains a comment. /
INVALID OPENFILE mode
An invalid parameter followed the OPENFILE command. Valid OPENFILE parameters are READ, REWRITE, or APPEND. ;
Invalid Substitute VARIABLE
The specified VARIABLE name was not found. Make sure the variable is defined with a STRING command before using it. U
Invalid UPLOAD keyword or keyword option
One of the ASCII UPLOAD keywords was misspelled or contains an invalid parameter. Correct the keyword(s) and parameters and retry. #
LABEL not found
A LABEL was not found. Check the script for a possible omission or misspelling and try again.
Line too long
A script line exceeds 254 characters. Edit the Script and make sure lines are less than 254 characters. 9
LOADFON Filename not found
LOADFON expected a WORD parameter. The parameter was missing or a STRING was specified instead. 9
LOADKEY Filename not found
LOADKEY expected a WORD parameter. The parameter was missing or a STRING was specified instead. 1
LOG Filename not found
The LOG command expected a WORD parameter and it was either missing or a STRING was specified. 1
Off Screen Coordinates
The Row and/or Column argument(s) of a GOTOXY command was (were) invalid. Since GOTOXY is limited by BOX/WINDOW boundaries, make sure you reset any WINDOW or BOX commands before assuming a full 80x25 screen. =
ON or OFF parameter expected
The DEBUG command can only be followed by the WORD ON or OFF. Correct and retry. 1
PORT selection invalid
PORT expects a WORD in the range 1 to 8. It was either missing out of range. E
RETURN SCRIPT Filename not found
A Calling script was not found when a RETURN command was issued (IE, it was deleted or renamed). Execution cannot continue. Check to be sure you are not deleting/renaming the calling script by accident. 7
SCRIPT Filename not found
A called SCRIPT file was not found. The script filename parameter was missing, or the file could not be located. =
SCRIPT/GOSUB nested too deep
SCRIPT and/or GOSUB commands were nested more than 40 levels. Some serious thought needs to be put into the script(s) to reduce the levels of nesting. I
SETCOMM Keyword or Letter expected
An invalid parameter was used in a SETCOMM command. #
STRING expected
A command required a STRING, but it was either missing or a WORD was specified. #
STRING length 0
A null string was used. The string must be at least 1 character. )
STRING not defined
The string variable used in a command was not defined. Define the variable with the STRING command and try again. 5
STRING VARIABLE expected
A string variable command parameter was missing, misspelled, or not defined. 5
Substitute Line too long
String variable substitution yielded a line longer than 254 characters. Use additional WRITE/DISPLAY/SEND commands to break up the line into shorter ones. ;
SYSTEM parameter not Y or X
X and Y are the only valid arguments of the SYSTEM command. Correct and try again. E
Target LABEL cannot be a KEYWORD
A reserved script keyword was used as a label. Correct and try again. #
Too many PUSHes
More than 40 values were PUSHed onto the stack without any intervening POPs. 3
Too many WHEN's defined
The maximum of 30 WHEN commands were active and an additional WHEN was issued. Use a blank WHEN command to clear unused WHENs and try again. ?
TURNOFF Keywords(s) not found
A TURNOFF keyword was missing or invalid. ;
TURNON Keyword(s) not found
A TURNON keyword was missing or invalid. A
UPLOAD Filename does not Exist
The UPLOAD filename did not exist. Verify the filename and try again. 5
UPLOAD Filename expected
The FILENAME argument of the UPLOAD command was not a WORD or was missing.
WORD expected
A WORD argument was expected, but it was missing or a STRING was used. 1
WORD or LABEL expected
A WORD or LABEL argument was expected, but it was missing or a STRING was used. 3
WORD or STRING expected
A WORD or string argument was expected, but was not found. This is usually caused by a missing parameter.
Script Tokens
The following list are the valid Tokens for the Script TURNON and TURNOFF commands. Refer to the Script documentation for specific usage of these tokens.
8_BIT BS_DEL CASE
ECHO MUSIC NOISE
LINEFEED DOORWAY ONLINE
PRINT SCROLL SPLIT
STATUSLN XON/XOFF
Script Keywords
The following list are the valid Script Keywords. Refer to the Script documentation for specific usage of these commands.
ASSIGN ATWRITE BEEP
BIGDOS BOX BREAK
CAPTURE CHDIR CLOSEFILE
CLRSCR COLOR COLORBG
COLORFG DEBUG DECR
DELAY DELETEF DEVICE
DIAL DISPLAY DISPLAYLN
DOS DOWNLD DOWNLOAD
DRIVE EDIT EGA
EXIST EXIT FKEY
FLUSH GET GETN
GETNR GETR GETSCR
GETX GOSUB GOTO
GOTOXY GRAPHICS HANGUP
HOST IF INCR
INKEY LOADFON LOADKEY
LOG NOTE OPENFILE
PAUSE POP PORT
PUSH PUTSCR READFILE
RENAMEF RETURN SCRIPT
SEND SETCOMM STAMP
STRING SYSTEM TIMEOUT
TURNOFF TURNON UPLD
UPLOAD WAITFOR WAITUNTIL
WHEN WINDOW WRITE
WRITEFILE WRITELN
The QmodemPro Menus
Most commands in QmodemPro can be accessed through the menu bar at the top of the screen. This menu is always available, except when you are in a dialog box that requires input before QmodemPro can continue. Each item on the main menu has an associated pull-down menu.
Use the Tab key to select which menu you would like to know more about, then press Enter. Or, double click on your selection below. E
Files
Phonebook
Device
Video
Host
Mail
Scripts
Config
Help
The QmodemPro Status Line
The Status Line is displayed on the bottom line of the QmodemPro Terminal screen. Here is a sample status line (press F5 to see the complete status line):
ANSI Offline 19200 8N1 [Alt+Z]-Menu FDX 8 LF X d
CP LG
PR 11:57:19
ANSI - This indicates which terminal
emulation is
currently active.
Offline - This indicates that the modem is Offline. This
may also say ONLINE.
19200 - This indicates the current DTE baud rate.
8N1 - This indicates the current communications port
parameters of 8 data bits, No parity, and 1 stop
bit.
[Alt+Z] - Press Alt+Z to access the menu
FDX - Full Duplex. May also say HDX for Half duplex.
8 - 8 full bits are accessed. May be 7 if 8th bit
strip is enabled.
LF - Highlighted if "Add LF after CR" is enabled.
X - Highlighted if Xon/Xoff is enabled.
d - Highlighted if Beeps & Bells are turned on.
- Highlighted if ANSI music is turned on.
CP - Highlighted if Capture is turned on.
LG - Highlighted if Logging is turned on.
- Highlighted if there is scroll back data.
PR - Highlighted if the printer is toggled on.
11:57:19 - The current time of day if offline, or the total
elapsed time if online.
File Transfer Protocols
ASCII
The ASCII protocol is used primarily for on-line text file transfers. It does not support the transfer of binary data such as programs or compressed files. There is no error checking performed during the transfer which makes it highly susceptible to line noise. It is advised to use XON/XOFF software flow control with this protocol. Failure to do so may cause loss of data. :
XMODEM
The Xmodem protocol is a block oriented file transfer protocol capable of sending text and binary data. It uses a simple checksum error detection algorithm with an accuracy rate of 99.6%. Xmodem uses a 128-byte data block that requires the remote to acknowledge each block as it is received. :
XMODEM-CRC
Xmodem-CRC is a slightly modified Xmodem protocol that uses a more robust error detection algorithm (CRC) with an accuracy rate of 99.9969%. :
1K-XMODEM
1K-Xmodem is based on the Xmodem-CRC protocol, but increases the size of the data packets (blocks) to 1024 bytes. This can increase throughput dramatically for modems that do not support built-in error-correction. :
1K-XMODEM/G
1K-Xmodem/G is based on the 1K-Xmodem protocol with the additional support for modems and devices that have built-in error detection and correction. Since the modems handle any bad blocks, no error detection is done by the protocol. This also means that the receiving side does not have to acknowledge the receipt of each block and so the protocol is considered a "streaming" protocol. :
YMODEM
The Ymodem protocol is a true implementation of the YMODEM BATCH protocol and supports the transfer of multiple files within a single transfer session without user intervention. It is based on the 1K-Xmodem protocol with the inclusion of file "headers" that describe the file or files sent to the receiver. Blocks can vary between 128 and 1024-byte packets. :
YMODEM/G
Ymodem/G is the "streaming" version of the Ymodem protocol. :
ZMODEM
Zmodem is a popular streaming protocol that supports such features as batch transfers, varying block sizes and "Crash Recovery". The latter being useful to resume a failed transfer at the point it failed. :
KERMIT
This is the transfer protocol that became popular in the early 70's that allowed mini and mainframes to exchange data and files. Kermit was created at Columbia University and is available for free for any system that requests it. This protocol supports batch transfers like Ymodem. In addition, support for newer options such as "Sliding Windows" and "Long Packets" has been included. :
CIS B+
This protocol is used by CompuServe to speed transfers to/from the CIS mainframe. All three implementations of CIS B (B, B+ and Quick-B) are supported automatically.
System Name
This is the name of the System or BBS you are dialing. It can be any text string up to 27 characters in length. Descriptive names are encouraged.
Primary Number
This is the Primary number used for dialing. This number is the first number that will be tried. If you are also using Alternate
Numbers, then this should be the entry you always want to try first.
Numbers are limited to 19 characters. If you need more characters for long-distance carriers such as MCI or Sprint, then use the Device Prefix modifiers to extend the number.
Alternate Number
These are alternate numbers that should be dialed if the Primary
Number is busy or disabled for some reason. You can have up to 4 alternate numbers for any one system.
Numbers are limited to 19 characters. If you need more characters for long-distance carriers such as MCI or Sprint, then use the Device Prefix modifiers to extend the number.
Retries
This setting allows you to control how many times the entry is redialed if you do not get a connection for whatever reason. A value of 0 (zero) means there is no limit.
User-ID
This field stores your User-ID or Name for the system. When using a BBS, this might be your first and last name. If you are calling CompuServe, this should be set to your CIS ID. It is important that when using the QMGATE program, it expects this field to be filled in with your CIS or MCI User ID. You are allowed up to 30 characters. T
When using scripts, this field will be transferred to the $USERID script variable.
Password
This field stores your Password for the system. It is important that when using the QMGATE program, it expects this field to be filled in with your Password to CIS or MCI. You are allowed 25 characters. V
WHen using scripts, this field will be transferred to the $PASSWORD script variable.
Memo
This field stores a short 30 character Memo about the entry. If the entry is marked as Fax Dial Only, then this field will automatically transfer to the "To:" field in the Send Fax dialog. If you always send a fax to the same person, then save a step and use the Memo field for this.
Key File
This is the name of a keyboard template to use with this system. If left blank, the name of the Emulation will be used instead. If you have a system that needs custom macros and have already created the KEY file, fill in the name here. Do not include the extension ".KEY" as that is the default and will be forced when the KEY file is loaded.
Script File
This is the name of a Script file to be executed when you connect to the system. Do not include the ".SCR" extension as this is forced when the Script is loaded. If the script does not already exist, the QuickLearn will be turned on automatically and "learn" from your keystrokes.
Packet Name
This is the name of a MAIL packet that is associated with the system. With QWK/REP mail systems, this name is unique to the system being called. Consult with the System Operator (SYSOP) of the BBS as to what name should be placed in here.
If you are using CompuServe or MCI mail, then the packet name should be CISMAIL or MCIMAIL respectively. The QMGATE program will expect these packet names in this field.
The Packet name is the key to enabling the [Read New Mail] and [Send Replies] buttons in the dialing directory. At least one entry in the phonebook must have a Packet defined for these buttons to work.
Device to use
This is the device to use when dialing the system. If the Device name exists in you Config Device list, then that device will be selected and initialized just prior to dialing. If the device name does -not- exist in your list, then the "Default Device" you have defined is used. To select a different device, press the down arrow, or click the pointer with the mouse.
There are two special cases, "**Default Device**" and "**Current Device**" that can be assigned. The device "**Default Device**" will always reference the device you have made the default in Config/Device. The device "**Current Device**" will always reference the currently active device. This could be the last dialed device, or the last device selected with the Alt+K command.
Emulation
This field defines the terminal emulation to be selected when you connect with this system. To select a different emulation, press the down arrow or click the pointer with the mouse.
Transfer Protocol
This is the default transfer protocol to be selected when you press PgUp or PgDn from terminal mode. To select a different protocol, press the down arrow or click the pointer with the mouse.
Fax Options
Check the Fax Device Only box if you wish this entry to send faxes. You should also verify that the Device to use is also defined as a "Fax Device". This is required to enable QmodemPro to send faxes.
Duplex
This setting controls the Duplex used when you connect to the system. In most cases, you would have "Full" selected. If you see your text doubled, or not at all when you type, this means you have the wrong Duplex selected.
Connects
This field stores the total number of times you dialed -and connected- to this system. You can manually change this field to any value in the range of 0 to 9999999.
Clear Call Info
This button clears the Last-Date, Last-Time and Connects fields.
ASCII Upload Options
CR Handling
) Send CR
( ) Add LF after CR
( ) Strip
This controls how the CR (Carriage Return) character is handled in the upload. When a CR character (^M, decimal 13) is encountered, it will either be sent out unmodified, sent with the LF (Line Feed, ^J, decimal 10) character following it, or stripped entirely. The default is to send out unmodified.
LF Handling
) Send LF
( ) Add CR before LF
( ) Strip
This controls how the LF (Line feed) character is handled in the upload. When a LF character (^J, decimal 10) is encountered, it will either be sent out unmodified, sent with a preceding CR (carriage return), or stripped. The default is to send out unmodified. ^
Toggles
[ ] Use Xlate table
When checked, the characters will first pass through the active Output translate table for the current emulation. Then they pass through the CR handling and LF handling. U
[X] Expand blank lines
When checked, any line that is of zero length will be padded with a single SPACE character before being sent. Some systems key on a blank line to end the input of text, such as online message entry systems. This will allow you to have blank lines in your file and not have the editor stop before you are finished uploading. U
[ ] Send ^Z EOF Marker
When checked, a ^Z (decimal 26) character will be sent at the end of your text file. U
EOL Character
10
This is the decimal value of the End Of Line character. In standard ASCII text files, this is the LF (Line feed) character. U
Pace Character
0
This is the decimal value of the Pace Character. When uploading, if this is a non-zero value, then each line is sent after receiving the character defined. Some editors will always send a character, such as ":" to prompt for another line of input. U
Speed (ms.)
0
This is the amount of delay, in milliseconds, that occurs after each character is sent. A value of 0 means no delays.
ASCII Download Options
CR Handling
) Send CR
( ) Add LF after CR
( ) Strip
This controls how the CR (Carriage Return) character is handled in the download. When a CR character (^M, decimal 13) is encountered, it will either be saved unmodified, saved with the LF (Line Feed, ^J, decimal 10) character following it, or stripped entirely. The default is to save unmodified.
LF Handling
) Send LF
( ) Add CR before LF
( ) Strip
This controls how the LF (Line feed) character is handled in the download. When a LF character (^J, decimal 10) is encountered, it will either be saved unmodified, saved with a preceding CR (carriage return), or stripped. The default is to save unmodified. ^
Toggles
[ ] Use Xlate table
When checked, the characters will pass through the active Input translate table for the current emulation. Then they pass through the CR handling and LF handling. [
Timeout (seconds)
60
This is the maximum amount of time in seconds that can pass without receiving a character before the transfer is ended. The download may start and stop due to flow control, but should there be a pause that exceeds this many seconds, the transfer will end.
Scroll-Back
This is the Scroll back window. You can use your arrow keys, PgUp, PgDn, Home and End to view the contents. Press S to Save the contents to a file or printer. Press C to Clear the Scroll-Back. W
Note: The S command does not save color to the file or printer, just the ASCII text.
(.txt)